From: Fred Drake <fdrake@acm.org>
Date: Thu, 2 May 2002 05:59:15 +0000 (+0000)
Subject: Add information on support for repietition & concatenation for buffer
X-Git-Tag: 2.1~45
X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=86c02403f819c1d0d5fb0497e01e1f2212bf158f;p=thirdparty%2FPython%2Fcpython.git

Add information on support for repietition & concatenation for buffer
and xrange objects, and generally present these in the same way that more
recent documentation releases present them (for ease of maintenance).
This closes SF bug #550555.
---

diff --git a/Doc/lib/libstdtypes.tex b/Doc/lib/libstdtypes.tex
index 998d6219295d..2e5dfee96695 100644
--- a/Doc/lib/libstdtypes.tex
+++ b/Doc/lib/libstdtypes.tex
@@ -328,18 +328,26 @@ separating items with commas: \code{[a, b, c]}.  Tuples are
 constructed by the comma operator (not within square brackets), with
 or without enclosing parentheses, but an empty tuple must have the
 enclosing parentheses, e.g., \code{a, b, c} or \code{()}.  A single
-item tuple must have a trailing comma, e.g., \code{(d,)}.  Buffers are
-not directly supported by Python syntax, but can be created by calling the
-builtin function \function{buffer()}.\bifuncindex{buffer}  XRanges
-objects are similar to buffers in that there is no specific syntax to
-create them, but they are created using the \function{xrange()}
-function.\bifuncindex{xrange}
+item tuple must have a trailing comma, e.g., \code{(d,)}.
 \obindex{sequence}
 \obindex{string}
 \obindex{Unicode}
-\obindex{buffer}
 \obindex{tuple}
 \obindex{list}
+
+Buffers are not directly supported by Python syntax, but can be
+created by calling the builtin function
+\function{buffer()}.\bifuncindex{buffer}  They support
+concatenation and repetition, but the result is a new string object
+rather than a new buffer object.
+\obindex{buffer}
+
+Xrange objects are similar to buffers in that there is no specific
+syntax to create them, but they are created using the
+\function{xrange()} function.\bifuncindex{xrange}  They don't support
+slicing or concatenation, but do support repetition, and using
+\code{in}, \code{not in}, \function{min()} or \function{max()} on them
+is inefficient.
 \obindex{xrange}
 
 Sequence types support the following operations.  The \samp{in} and