* doc/: Heavily improve documentation

Complete the documentation of pkgCache, pkgDepCache, pkgCache::Package.

Introduce new documentation for pkgCache::Version, pkgCache::Dependency,
pkgCache::PackageFile, pkgcache::Description.

There is also an example now which checks for missing dependencies.

1 files changed, 22 insertions, 0 deletions

diff --git a/doc/source/examples/cache-packages.py b/doc/source/examples/cache-packages.py
new file mode 100644
index 00000000..1abe7cf2
--- /dev/null
+++ b/doc/source/examples/cache-packages.py
@@ -0,0 +1,22 @@
+#!/usr/bin/python
+"""Example for packages. Print all essential and important packages"""
+
+import apt_pkg
+
+
+def main():
+    """Main."""
+    apt_pkg.InitConfig()
+    apt_pkg.InitSystem()
+    cache = apt_pkg.GetCache()
+    print "Essential packages:"
+    for pkg in cache.Packages:
+        if pkg.Essential:
+            print " ", pkg.Name
+    print "Important packages:"
+    for pkg in cache.Packages:
+        if pkg.Important:
+            print " ", pkg.Name
+
+if __name__ == "__main__":
+    main()