SF bug #655271: Slightly modify locals() doc

Clarify the operation of locals().

diff --git a/Doc/lib/libfuncs.tex b/Doc/lib/libfuncs.tex
index 85ead28fdb6e0c62ffe00a7778ae17921fd2e05c..d5b565f4a44aaedc1c5c9996d71ddd73d3ff9f48 100644 (file)
--- a/Doc/lib/libfuncs.tex
+++ b/Doc/lib/libfuncs.tex
@@ -624,7 +624,7 @@ class C:
 \end{funcdesc}
 
 \begin{funcdesc}{locals}{}
-  Return a dictionary representing the current local symbol table.
+  Update and return a dictionary representing the current local symbol table.
   \warning{The contents of this dictionary should not be modified;
   changes may not affect the values of local variables used by the
   interpreter.}

diff --git a/Python/bltinmodule.c b/Python/bltinmodule.c
index ad0625016f2be019e99f7837c9e16e09d12b56cc..45ea4dcf8787e56ba2ab89d90ca7d1830f493200 100644 (file)
--- a/Python/bltinmodule.c
+++ b/Python/bltinmodule.c
@@ -1041,7 +1041,7 @@ builtin_locals(PyObject *self)
 PyDoc_STRVAR(locals_doc,
 "locals() -> dictionary\n\
 \n\
-Return the dictionary containing the current scope's local variables.");
+Update and return a dictionary containing the current scope's local variables.");
 
 
 static PyObject *