About half of those @deprecated PHPdocs are simply for completion sake.

Originally I had targetted 3.1 as the release, so there are still some areas where I need to update these deprecations to 3.2.

Also I'll make it a task to run through all the old database API and re-introduce placeholder functions with the correct deprecation.