]> git.ipfire.org Git - thirdparty/Python/cpython.git/commitdiff
backport bug [ 1166582 ] IterableUserDict not in docs
authorGeorg Brandl <georg@python.org>
Sat, 25 Jun 2005 21:03:57 +0000 (21:03 +0000)
committerGeorg Brandl <georg@python.org>
Sat, 25 Jun 2005 21:03:57 +0000 (21:03 +0000)
Doc/lib/libuserdict.tex

index ef643cc50a9d47f01f351bae32973c80adc70525..5749ebec2f0a73a7ec3ab416edc4209b76a90b3f 100644 (file)
@@ -27,12 +27,18 @@ contents are kept in a regular dictionary, which is accessible via the
 \member{data} attribute of \class{UserDict} instances.  If
 \var{initialdata} is provided, \member{data} is initialized with its
 contents; note that a reference to \var{initialdata} will not be kept, 
-allowing it be used for other purposes.
+allowing it be used for other purposes. \note{For backward compatibility,
+instances of \class{UserDict} are not iterable.}
+\end{classdesc}
+
+\begin{classdesc}{IterableUserDict}{\optional{initialdata}}
+Subclass of \class{UserDict} that supports direct iteration (e.g.
+\code{for key in myDict}).
 \end{classdesc}
 
 In addition to supporting the methods and operations of mappings (see
-section \ref{typesmapping}), \class{UserDict} instances provide the
-following attribute:
+section \ref{typesmapping}), \class{UserDict} and
+\class{IterableUserDict} instances provide the following attribute:
 
 \begin{memberdesc}{data}
 A real dictionary used to store the contents of the \class{UserDict}