From 8141cf5c76a1a47ccacc14aa4594fcc89499799a Mon Sep 17 00:00:00 2001
From: Guido van Rossum <guido@python.org>
Date: Tue, 8 Aug 2000 16:15:49 +0000
Subject: [PATCH] Barry's patch to document the new setdefault() method. 
 Slightly clarified the summary for default() in the table to indicate the
 side effect.

---
 Doc/lib/libstdtypes.tex | 8 ++++++++
 1 file changed, 8 insertions(+)

diff --git a/Doc/lib/libstdtypes.tex b/Doc/lib/libstdtypes.tex
index 842b23ba08a..3adfc6e4d9b 100644
--- a/Doc/lib/libstdtypes.tex
+++ b/Doc/lib/libstdtypes.tex
@@ -591,6 +591,10 @@ arbitrary objects):
           {\code{\var{a}[\var{k}]} if \code{\var{a}.has_key(\var{k})},
            else \var{x}}
           {(4)}
+  \lineiii{\var{a}.setdefault(\var{k}\optional{, \var{x}})}
+          {\code{\var{a}[\var{k}]} if \code{\var{a}.has_key(\var{k})},
+           else \var{x} (also setting it)}
+          {(5)}
 \end{tableiii}
 
 \noindent
@@ -611,6 +615,10 @@ correspond.  This allows the creation of \code{(\var{value},
 \item[(4)] Never raises an exception if \var{k} is not in the map,
 instead it returns \var{x}.  \var{x} is optional; when \var{x} is not
 provided and \var{k} is not in the map, \code{None} is returned.
+
+\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}.
 \end{description}