Bug#807103: python-apt-doc: Documentation describes removed functions

[Felix Dietrich <felix.dietrich@sperrhaken.name>]

Package: python-apt-doc
Version: 1.1.0~beta1
Severity: important

The documentation describes, as well as uses these in its examples,
functions that are no longer part of the python-apt modules (such as
apt_inst.debExtract).  While these are usually marked as deprecated and
the description points to the superseding functions, examples fail to
run with errors making it harder to get started with python-apt.

I am interested to work on documentation and examples or help whomever
is currently at it, but I am uncertain how to deal with the now removed
functions in the describing part of the documentation: Should their
describtions simply be deleted? Moved to another section of the
documentation archiving the old interface? Amended with a note stating
that these functions have been removed and the versionnumber
corresponding to the removal?

--
Felix Dietrich