]> git.ipfire.org Git - thirdparty/Python/cpython.git/commitdiff
Nits from a review of the documentation update.
authorRaymond Hettinger <python@rcn.com>
Wed, 26 Nov 2003 17:52:45 +0000 (17:52 +0000)
committerRaymond Hettinger <python@rcn.com>
Wed, 26 Nov 2003 17:52:45 +0000 (17:52 +0000)
Doc/lib/libfuncs.tex
Doc/lib/libsets.tex
Doc/tut/tut.tex
Doc/whatsnew/whatsnew24.tex

index 5aa0c18b73b509ce4c2f367222e9eb5edebc8795..61880aeaa087d8e13c2e313be25ff355bc445d88 100644 (file)
@@ -1063,7 +1063,7 @@ It's a function
 
   \versionchanged[Formerly, \function{zip()} required at least one argument
   and \code{zip()} raised a \exception{TypeError} instead of returning
-  \code{[]}]{2.4} 
+  an empty list.]{2.4} 
 \end{funcdesc}
 
 
index 5f98967b5591a40468414a711eedb1f4698b71e7..6d49b16e9d13a8c4ba4185eac419e527193f5ef7 100644 (file)
@@ -91,7 +91,7 @@ the following operations:
          {new set with a shallow copy of \var{s}}
 \end{tableiii}
 
-Note, this non-operator versions of \method{union()},
+Note, the non-operator versions of \method{union()},
 \method{intersection()}, \method{difference()}, and
 \method{symmetric_difference()} will accept any iterable as an argument.
 In contrast, their operator based counterparts require their arguments to
@@ -158,10 +158,7 @@ but not found in \class{ImmutableSet}:
          {remove all elements from set \var{s}}
 \end{tableiii}
 
-\versionchanged[Earlier versions had an \method{update()} method; use
-                \method{union_update()} instead]{2.3.1}
-
-Note, this non-operator versions of \method{union_update()},
+Note, the non-operator versions of \method{union_update()},
 \method{intersection_update()}, \method{difference_update()}, and
 \method{symmetric_difference_update()} will accept any iterable as
 an argument.
index ce941f3ae4b750617bdc8a2de135e1ecb97f4587..56dd395587f36d4b2453c76d7b01ead8d9316823 100644 (file)
@@ -2161,11 +2161,11 @@ pattern, list comprehensions can compactly specify the key-value list.
 \section{Looping Techniques \label{loopidioms}}
 
 When looping through dictionaries, the key and corresponding value can
-be retrieved at the same time using the \method{items()} method.
+be retrieved at the same time using the \method{iteritems()} method.
 
 \begin{verbatim}
 >>> knights = {'gallahad': 'the pure', 'robin': 'the brave'}
->>> for k, v in knights.items():
+>>> for k, v in knights.iteritems():
 ...     print k, v
 ...
 gallahad the pure
@@ -3957,7 +3957,7 @@ list, and the function object is called with this new argument list.
 
 \section{Random Remarks \label{remarks}}
 
-[These should perhaps be placed more carefully...]
+[These should perhaps be placed more carefully...]
 
 
 Data attributes override method attributes with the same name; to
index 0f5e546db909be8e98420dd265c3fd008196480d..2e573b56b019b5c356f6439aac01aa8551c48412 100644 (file)
@@ -12,7 +12,7 @@
 \tableofcontents
 
 This article explains the new features in Python 2.4.  No release date
-for Python 2.4 has been set; expect that this will happen in 2004.
+for Python 2.4 has been set; expect that this will happen mid-2004.
 
 While Python 2.3 was primarily a library development release, Python
 2.4 may extend the core language and interpreter in
@@ -42,6 +42,7 @@ False
 set(['a', 'r', 'b', 'c', 'd'])
 >>> ''.join(a)                          # convert back into a string
 'arbcd'
+
 >>> b = set('alacazam')                 # form a second set
 >>> a - b                               # letters in a but not in b
 set(['r', 'd', 'b'])
@@ -51,6 +52,7 @@ set(['a', 'c', 'r', 'd', 'b', 'm', 'z', 'l'])
 set(['a', 'c'])
 >>> a ^ b                               # letters in a or b but not both
 set(['r', 'd', 'b', 'm', 'z', 'l'])
+
 >>> a.add('z')                          # add a new element
 >>> a.update('wxy')                     # add multiple new elements
 >>> a
@@ -115,6 +117,11 @@ Here are all of the changes that Python 2.4 makes to the core Python
 language.
 
 \begin{itemize}
+
+\item The string methods, \method{ljust()}, \method{rjust()}, and
+\method{center()} now take a optional argument for specifying a
+fill character other than a space.
+
 \item The \method{sort()} method of lists gained three keyword
 arguments, \var{cmp}, \var{key}, and \var{reverse}.  These arguments
 make some common usages of \method{sort()} simpler.  All are optional.
@@ -185,10 +192,12 @@ use in expressions.  The differences are:
 [11, 12, 13, 14, 15, 16, 17, 18, 19]
 >>> L = [9,7,8,3,2,4,1,6,5]         # original is left unchanged
 [9,7,8,3,2,4,1,6,5]   
+
 >>> list.sorted('Monte Python')     # any iterable may be an input
 [' ', 'M', 'P', 'e', 'h', 'n', 'n', 'o', 'o', 't', 't', 'y']
+
+>>> # List the contents of a dict sorted by key values
 >>> colormap = dict(red=1, blue=2, green=3, black=4, yellow=5)
->>> # Lists the contents of the dict sorted by key values
 >>> for k, v in list.sorted(colormap.iteritems()):
 ...     print k, v
 ...
@@ -202,7 +211,7 @@ yellow 5
 
 
 \item The \function{zip()} built-in function and \function{itertools.izip()}
-  now return an empty list instead of raising a \exception{TypeError}
+  now returns an empty list instead of raising a \exception{TypeError}
   exception if called with no arguments.  This makes the functions more
   suitable for use with variable length argument lists:
 
@@ -297,6 +306,12 @@ Changes to Python's build process and to the C API include:
   objN)}, constructs tuples from a variable length argument list of
   Python objects.
 
+  \item A new function, \function{PyDict_Contains(d, k)}, implements
+  fast dictionary lookups without masking exceptions raised during
+  the loop-up process (compare with \function{PySequence_Contains()}
+  which is slower or \function{PyMapping_HasKey()} which clears all
+  exceptions).
+
 \end{itemize}