"Documentation" for {}.popitem().
diff --git a/Doc/lib/libstdtypes.tex b/Doc/lib/libstdtypes.tex
index 91dd675..da7ef0d 100644
--- a/Doc/lib/libstdtypes.tex
+++ b/Doc/lib/libstdtypes.tex
@@ -817,6 +817,9 @@
{\code{\var{a}[\var{k}]} if \code{\var{a}.has_key(\var{k})},
else \var{x} (also setting it)}
{(5)}
+ \lineiii{\var{a}.popitem()}
+ {remove and return an arbitrary (\var{key}, \var{value}) pair}
+ {(6)}
\end{tableiii}
\noindent
@@ -841,6 +844,9 @@
\item[(5)] \function{setdefault()} is like \function{get()}, except
that if \var{k} is missing, \var{x} is both returned and inserted into
the dictionary as the value of \var{k}.
+
+\item[(6)] \function{popitem()} is useful to destructively iterate
+over a dictionary, as often used in set algorithms.
\end{description}