diff -r 53f80427f105 Doc/library/dbm.rst
--- a/Doc/library/dbm.rst	Wed Mar 23 23:02:31 2011 +0100
+++ b/Doc/library/dbm.rst	Thu Mar 24 19:26:46 2011 +0800
@@ -69,6 +69,15 @@
 .. versionchanged:: 3.2
    :meth:`get` and :meth:`setdefault` are now available in all database modules.
 
+.. note::
+
+   Some limitations of the dbm objects api: For dbm.gnu object and dbm.dumb
+   object, :meth:`values`, :meth:`items`, :meth:`pop`, :meth:`popitem`,
+   :meth:`clear`, :meth:`update` are not available, :meth:`keys` returns a list
+   instead of a view object, iteration is not supported.  For dbm.dumb object,
+   the :meth:`keys` and :meth:`items` of dbm.dumb object return lists instead
+   of view objects.
+
 Key and values are always stored as bytes. This means that when
 strings are used they are implicitly converted to the default encoding before
 being stored.