From: Benjamin Peterson <benjamin@python.org>
Date: Wed, 22 Apr 2015 13:16:07 +0000 (-0400)
Subject: improved range docstring (closes #22785)
X-Git-Tag: v3.5.0b1~305^2
X-Git-Url: http://git.ipfire.org/?a=commitdiff_plain;h=ac22c6b923d12e2b9069324c82a95d2353d0cd28;p=thirdparty%2FPython%2Fcpython.git

improved range docstring (closes #22785)

Patch by Ned Batchelder.
---

diff --git a/Objects/rangeobject.c b/Objects/rangeobject.c
index 7e6c733f3e28..ca66a45d5fe4 100644
--- a/Objects/rangeobject.c
+++ b/Objects/rangeobject.c
@@ -139,7 +139,11 @@ PyDoc_STRVAR(range_doc,
 "range(stop) -> range object\n\
 range(start, stop[, step]) -> range object\n\
 \n\
-Return a sequence of numbers from start to stop by step.");
+Return an object that produces a sequence of integers from start (inclusive)\n\
+to stop (exclusive) by step.  range(i, j) produces i, i+1, i+2, ..., j-1.\n\
+start defaults to 0, and stop is omitted!  range(4) produces 0, 1, 2, 3.\n\
+These are exactly the valid indices for a list of 4 elements.\n\
+When step is given, it specifies the increment (or decrement).");
 
 static void
 range_dealloc(rangeobject *r)