Move deprecated methods to their own section.

They were cluttering up the main interface documentation, so now
they've been moved out of the way.
Merge pull request #4 from pjf/master

Move deprecated methods to their own section.