* doc:

  - Various documentation updates.

3 files changed, 32 insertions, 7 deletions

diff --git a/debian/changelog b/debian/changelog
index 0bde1557..c3971451 100644
--- a/debian/changelog
+++ b/debian/changelog
@@ -5,6 +5,8 @@ python-apt (0.7.98.2) unstable; urgency=low
       the equivalent apt_inst.DebFile API (Closes: #603043)
   * apt/package.py:
     - Fix docstring of Package.mark_delete() (Closes: #599042)
+  * doc:
+    - Various documentation updates.
   * po
     - Update sl.po (Closes: #603359)
 
diff --git a/doc/source/library/apt_pkg.rst b/doc/source/library/apt_pkg.rst
index 81dafd54..f1bc4845 100644
--- a/doc/source/library/apt_pkg.rst
+++ b/doc/source/library/apt_pkg.rst
@@ -1600,6 +1600,10 @@ section as a string.
         tagf = apt_pkg.TagFile(open('/var/lib/dpkg/status'))
         for section in tagfile:
             print section['Package']
+
+    .. versionchanged:: 0.7.100
+        Added support for using gzip files, via :class:`gzip.GzipFile` or any
+        file containing a compressed gzip stream.
         
     .. method:: next()
 
@@ -1653,7 +1657,7 @@ section as a string.
 
         Return ``True`` if *section* has a key *key*, else ``False``.
 
-      .. versionadded:: 0.8.0
+      .. versionadded:: 0.7.100
 
     .. method:: bytes() -> int
 
@@ -1833,6 +1837,8 @@ Configuration and Command-line parsing
         Return a string containing the values in the configuration object,
         in the standard :manpage:`apt.conf(5)` format.
 
+        .. versionadded:: 0.7.100
+
     .. method:: exists(key)
 
         Check whether an option named *key* exists in the configuration.
diff --git a/doc/source/whatsnew/0.7.100.rst b/doc/source/whatsnew/0.7.100.rst
index b7768405..a691c6a1 100644
--- a/doc/source/whatsnew/0.7.100.rst
+++ b/doc/source/whatsnew/0.7.100.rst
@@ -8,10 +8,14 @@ Despite the many changes made in python-apt 0.7.100, the release still provides
 backwards compatibility to the 0.7 series. This makes it possible to run your
 old applications.
 
+This documents describes the important changes introduced since the release
+of python-apt 0.7.10.3, starting with the first development release 0.7.90
+from April 2009.
+
 .. note::
 
     Applications using the old API should be updated to the new API because
-    the old ones will be dropped in the 0.8 release. To build a python-apt
+    the old ones will be dropped in a future release. To build a python-apt
     variant without the deprecated API, build it without the -DCOMPAT_0_7
     compiler flag.
 
@@ -162,6 +166,13 @@ developers to provide Python support in the libapt-pkg-using application.
 
     The ABI is not considered stable yet.
 
+Redesign of :mod:`apt_inst`
+---------------------------
+The 0.7.100 series redesigns the :mod:`apt_inst` module to provide
+more flexible classes replacing the older functions. The older functions
+are still available in Python 2 builds, but are deprecated and will be
+removed in the future.
+
 Other changes
 -------------
 This release of python-apt also features several other, smaller changes:
@@ -170,14 +181,20 @@ This release of python-apt also features several other, smaller changes:
       :class:`apt.Package()` object dynamically, instead of creating all of
       them during the cache initialization.
     * Support to set the candidate version in :class:`apt.package.Package`
+    * Support for reading gzip-compressed files in apt_pkg.TagFile.
+    * Various changes to :mod:`apt.debfile` have been merged from gdebi.
+
+There have been various other changes, see the changelog for a complete list
+of changes.
+
 
-Porting your applications to python-apt 0.8 API
-------------------------------------------------
-Porting your application to the new python-apt 0.8 API may be trivial. You
+Porting your applications to the new python-apt API
+----------------------------------------------------
+Porting your application to the new python-apt API may be trivial. You
 should download the source tarball of python-apt and run the tool
-utils/migrate-0.8 using Python 2.6 over your code::
+utils/migrate-0.8 over your code::
 
-    python2.6 utils/migrate-0.8.py -c myapp.py mypackage/
+    utils/migrate-0.8.py -c myapp.py mypackage/
 
 This will search your code for places where possibly deprecated names are
 used. Using the argument ``-c``, you can turn colorized output on.