From: Eric Smith <eric@trueblade.com>
Date: Sat, 6 Nov 2010 19:27:37 +0000 (+0000)
Subject: Added more to docstrings for str.format, format_map, and __format__.
X-Git-Tag: v3.2a4~94
X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;h=51d2fd983bcc85342b631e27a33e214c691e53be;p=thirdparty%2FPython%2Fcpython.git

Added more to docstrings for str.format, format_map, and __format__.
---

diff --git a/Objects/unicodeobject.c b/Objects/unicodeobject.c
index 35d86009f125..32bcb344f49e 100644
--- a/Objects/unicodeobject.c
+++ b/Objects/unicodeobject.c
@@ -9026,12 +9026,14 @@ unicode_endswith(PyUnicodeObject *self,
 PyDoc_STRVAR(format__doc__,
              "S.format(*args, **kwargs) -> str\n\
 \n\
-");
+Return a formatted version of S, using substitutions from args and kwargs.\n\
+The substitutions are identified by braces ('{' and '}').");
 
 PyDoc_STRVAR(format_map__doc__,
              "S.format_map(mapping) -> str\n\
 \n\
-");
+Return a formatted version of S, using substitutions from mapping.\n\
+The substitutions are identified by braces ('{' and '}').");
 
 static PyObject *
 unicode__format__(PyObject* self, PyObject* args)
@@ -9049,7 +9051,7 @@ unicode__format__(PyObject* self, PyObject* args)
 PyDoc_STRVAR(p_format__doc__,
              "S.__format__(format_spec) -> str\n\
 \n\
-");
+Return a formatted version of S as described by format_spec.");
 
 static PyObject *
 unicode__sizeof__(PyUnicodeObject *v)