* some docstrings added, more api fixing

2 files changed, 7 insertions, 2 deletions

diff --git a/apt/cache.py b/apt/cache.py
index 39640da7..7ec99c22 100644
--- a/apt/cache.py
+++ b/apt/cache.py
@@ -25,7 +25,11 @@ from apt.progress import OpTextProgress
 from UserDict import UserDict
 
 class Cache(object):
-    """ Package cache object """
+     """ Dictionary-like package cache 
+         This class has all the packages that are available in it's
+         dictionary
+     """
+
     def __init__(self, progress=None):
         self._callbacks = {}
         self.open(progress)
diff --git a/apt/package.py b/apt/package.py
index bae90b05..2368327b 100644
--- a/apt/package.py
+++ b/apt/package.py
@@ -23,7 +23,8 @@ import apt_pkg, string
 import random
 
 class Package(object):
-
+    """ This class represents a package in the cache
+    """
     def __init__(self, cache, depcache, records, pcache, pkgiter):
         """ Init the Package object """
         self._cache = cache             # low level cache