[ Web Proxy ]
URL:
Viewing: https://bugs.python.org/file46362/enumobject-docstrings.patch [Back]  [Original]

diff -r f44f44b14dfc Objects/clinic/enumobject.c.h
--- a/Objects/clinic/enumobject.c.h	Fri Jan 20 08:35:18 2017 +0200
+++ b/Objects/clinic/enumobject.c.h	Fri Jan 20 20:14:58 2017 +0200
@@ -6,14 +6,11 @@ PyDoc_STRVAR(enum_new__doc__,
 "enumerate(iterable, start=0)\n"
 "--\n"
 "\n"
-"Return an enumerate object.\n"
+"enumerate(iterable[, start]) -> iterator for index, value of iterable\n"
 "\n"
-"  iterable\n"
-"    an object supporting iteration\n"
-"\n"
-"The enumerate object yields pairs containing a count (from start, which\n"
-"defaults to zero) and a value yielded by the iterable argument.\n"
-"\n"
+"Return an enumerate object.  iterable must be another object that supports\n"
+"iteration.  The enumerate object yields pairs containing a count (from\n"
+"start, which defaults to zero) and a value yielded by the iterable argument.\n"
 "enumerate is useful for obtaining an indexed list:\n"
 "    (0, seq[0]), (1, seq[1]), (2, seq[2]), ...");
 
@@ -43,7 +40,9 @@ PyDoc_STRVAR(reversed_new__doc__,
 "reversed(sequence, /)\n"
 "--\n"
 "\n"
-"Return a reverse iterator over the values of the given sequence.");
+"reversed(sequence) -> reverse iterator over values of the sequence\n"
+"\n"
+"Return a reverse iterator");
 
 static PyObject *
 reversed_new_impl(PyTypeObject *type, PyObject *seq);
@@ -68,4 +67,4 @@ reversed_new(PyTypeObject *type, PyObjec
 exit:
     return return_value;
 }
-/*[clinic end generated code: output=9008c36999c57218 input=a9049054013a1b77]*/
+/*[clinic end generated code: output=1b4f534de00cd2de input=a9049054013a1b77]*/
diff -r f44f44b14dfc Objects/enumobject.c
--- a/Objects/enumobject.c	Fri Jan 20 08:35:18 2017 +0200
+++ b/Objects/enumobject.c	Fri Jan 20 20:14:58 2017 +0200
@@ -24,21 +24,20 @@ typedef struct {
 enumerate.__new__ as enum_new
 
     iterable: object
-        an object supporting iteration
     start: object = 0
 
-Return an enumerate object.
+enumerate(iterable[, start]) -> iterator for index, value of iterable
 
-The enumerate object yields pairs containing a count (from start, which
-defaults to zero) and a value yielded by the iterable argument.
-
+Return an enumerate object.  iterable must be another object that supports
+iteration.  The enumerate object yields pairs containing a count (from
+start, which defaults to zero) and a value yielded by the iterable argument.
 enumerate is useful for obtaining an indexed list:
     (0, seq[0]), (1, seq[1]), (2, seq[2]), ...
 [clinic start generated code]*/
 
 static PyObject *
 enum_new_impl(PyTypeObject *type, PyObject *iterable, PyObject *start)
-/*[clinic end generated code: output=e95e6e439f812c10 input=782e4911efcb8acf]*/
+/*[clinic end generated code: output=e95e6e439f812c10 input=42790bfcf1870428]*/
 {
     enumobject *en;
 
@@ -253,12 +252,14 @@ reversed.__new__ as reversed_new
     sequence as seq: object
     /
 
-Return a reverse iterator over the values of the given sequence.
+reversed(sequence) -> reverse iterator over values of the sequence
+
+Return a reverse iterator
 [clinic start generated code]*/
 
 static PyObject *
 reversed_new_impl(PyTypeObject *type, PyObject *seq)
-/*[clinic end generated code: output=f7854cc1df26f570 input=aeb720361e5e3f1d]*/
+/*[clinic end generated code: output=f7854cc1df26f570 input=35749f54dc7a8e22]*/
 {
     Py_ssize_t n;
     PyObject *reversed_meth;

Web Proxy Viewer  |  New URL  |  Original Page