Docs fixes, improved the consistency of the deprecation, thanks @englercj ...

Also added a comment on the bitmap font parser, will leave the change
until we find a new caching system

Moved the deprecation warnings to their own file, thanks @drkibitz for the suggestion