Update documentation of deprecated functions.

* old docs were either changed to use the new function name,
  or removed when appropriate.
Merge pull request #2244 from kmsquire/deprecated_doc_updates

Update documentation of deprecated functions.