Skip to content

Commit 902d6eb

Browse files
committed
Merged revisions 53005-53303 via svnmerge from
svn+ssh://pythondev@svn.python.org/python/trunk ........ r53012 | walter.doerwald | 2006-12-12 22:55:31 +0100 (Tue, 12 Dec 2006) | 2 lines Fix typo. ........ r53023 | brett.cannon | 2006-12-13 23:31:37 +0100 (Wed, 13 Dec 2006) | 2 lines Remove an unneeded import of 'warnings'. ........ r53025 | brett.cannon | 2006-12-14 00:02:38 +0100 (Thu, 14 Dec 2006) | 2 lines Remove unneeded imports of 'warnings'. ........ r53026 | brett.cannon | 2006-12-14 00:09:53 +0100 (Thu, 14 Dec 2006) | 4 lines Add test.test_support.guard_warnings_filter . This function returns a context manager that protects warnings.filter from being modified once the context is exited. ........ r53029 | george.yoshida | 2006-12-14 03:22:44 +0100 (Thu, 14 Dec 2006) | 2 lines Note that guard_warnings_filter was added in 2.6 ........ r53031 | vinay.sajip | 2006-12-14 09:53:55 +0100 (Thu, 14 Dec 2006) | 1 line Added news on recent changes to logging ........ r53032 | andrew.kuchling | 2006-12-14 19:57:53 +0100 (Thu, 14 Dec 2006) | 1 line [Patch #1599256 from David Watson] check that os.fsync is available before using it ........ r53042 | kurt.kaiser | 2006-12-15 06:13:11 +0100 (Fri, 15 Dec 2006) | 6 lines 1. Avoid hang when encountering a duplicate in a completion list. Bug 1571112. 2. Duplicate some old entries from Python's NEWS to IDLE's NEWS.txt M AutoCompleteWindow.py M NEWS.txt ........ r53048 | andrew.kuchling | 2006-12-18 18:12:31 +0100 (Mon, 18 Dec 2006) | 1 line [Bug #1618083] Add missing word; make a few grammar fixes ........ r53050 | andrew.kuchling | 2006-12-18 18:16:05 +0100 (Mon, 18 Dec 2006) | 1 line Bump version ........ r53051 | andrew.kuchling | 2006-12-18 18:22:07 +0100 (Mon, 18 Dec 2006) | 1 line [Bug #1616726] Fix description of generator.close(); if you raise some random exception, the exception is raised and doesn't trigger a RuntimeError ........ r53052 | andrew.kuchling | 2006-12-18 18:38:14 +0100 (Mon, 18 Dec 2006) | 1 line Describe new methods in Queue module ........ r53053 | andrew.kuchling | 2006-12-18 20:22:24 +0100 (Mon, 18 Dec 2006) | 1 line [Patch #1615868 by Lars Gustaebel] Use Py_off_t to fix BZ2File.seek() for offsets > 2Gb ........ r53057 | andrew.kuchling | 2006-12-18 22:29:07 +0100 (Mon, 18 Dec 2006) | 1 line Fix markup ........ r53063 | thomas.wouters | 2006-12-19 09:17:50 +0100 (Tue, 19 Dec 2006) | 5 lines Make sre's SubPattern objects accept slice objects like it already accepts simple slices. ........ r53065 | andrew.kuchling | 2006-12-19 15:13:05 +0100 (Tue, 19 Dec 2006) | 6 lines [Patch #1618455 by Ben Maurer] Improve speed of HMAC by using str.translate() instead of a more general XOR that has to construct a list. Slightly modified from Maurer's patch: the _strxor() function is no longer necessary at all. ........ r53066 | andrew.kuchling | 2006-12-19 15:28:23 +0100 (Tue, 19 Dec 2006) | 9 lines [Bug #1613651] Document socket.recv_into, socket.recvfrom_into Also, the text for recvfrom told you to read recv() for an explanation of the 'flags' argument, but recv() just pointed you at the man page. Copied the man-page text to recvfrom(), recvfrom_into, recv_into to avoid the pointless redirection. I don't have LaTeX on this machine; hope my markup is OK. ........ r53067 | andrew.kuchling | 2006-12-19 15:29:04 +0100 (Tue, 19 Dec 2006) | 1 line Comment typo ........ r53068 | andrew.kuchling | 2006-12-19 16:11:41 +0100 (Tue, 19 Dec 2006) | 1 line [Patch #1617413 from Dug Song] Fix HTTP Basic authentication via HTTPS ........ r53071 | andrew.kuchling | 2006-12-19 16:18:12 +0100 (Tue, 19 Dec 2006) | 1 line [Patch #1600491 from Jim Jewett] Describe how to build help files on Windows ........ r53073 | andrew.kuchling | 2006-12-19 16:43:10 +0100 (Tue, 19 Dec 2006) | 6 lines [Patch #1587139 by kxroberto] Protect lock acquisition/release with try...finally to ensure the lock is always released. This could use the 'with' statement, but the patch uses 'finally'. 2.5 backport candidate. ........ r53074 | vinay.sajip | 2006-12-19 19:29:11 +0100 (Tue, 19 Dec 2006) | 1 line Updated documentation for findCaller() to indicate that a 3-tuple is now returned, rather than a 2-tuple. ........ r53090 | georg.brandl | 2006-12-19 23:06:46 +0100 (Tue, 19 Dec 2006) | 3 lines Patch #1484695: The tarfile module now raises a HeaderError exception if a buffer given to frombuf() is invalid. ........ r53099 | raymond.hettinger | 2006-12-20 07:42:06 +0100 (Wed, 20 Dec 2006) | 5 lines Bug #1590891: random.randrange don't return correct value for big number Needs to be backported. ........ r53106 | georg.brandl | 2006-12-20 12:55:16 +0100 (Wed, 20 Dec 2006) | 3 lines Testcase for patch #1484695. ........ r53110 | andrew.kuchling | 2006-12-20 20:48:20 +0100 (Wed, 20 Dec 2006) | 17 lines [Apply length-checking.diff from bug #1599254] Add length checking to single-file mailbox formats: before doing a flush() on a mailbox, seek to the end and verify its length is unchanged, raising ExternalClashError if the file's length has changed. This fix avoids potential data loss if some other process appends to the mailbox file after the table of contents has been generated; instead of overwriting the modified file, you'll get the exception. I also noticed that the self._lookup() call in self.flush() wasn't necessary (everything that sets self._pending to True also calls self.lookup()), and replaced it by an assertion. 2.5 backport candidate. ........ r53112 | andrew.kuchling | 2006-12-20 20:57:10 +0100 (Wed, 20 Dec 2006) | 1 line [Bug #1619674] Make sum() use the term iterable, not sequence ........ r53113 | andrew.kuchling | 2006-12-20 20:58:11 +0100 (Wed, 20 Dec 2006) | 1 line Two grammar fixes ........ r53115 | andrew.kuchling | 2006-12-20 21:11:12 +0100 (Wed, 20 Dec 2006) | 5 lines Some other built-in functions are described with 'sequence' arguments that should really be 'iterable'; this commit changes them. Did I miss any? Did I introduce any errors? ........ r53117 | andrew.kuchling | 2006-12-20 21:20:42 +0100 (Wed, 20 Dec 2006) | 1 line [Bug #1619680] in_dll() arguments are documented in the wrong order ........ r53120 | neal.norwitz | 2006-12-21 05:38:00 +0100 (Thu, 21 Dec 2006) | 1 line Lars asked for permission on on python-dev for work on tarfile.py ........ r53125 | andrew.kuchling | 2006-12-21 14:40:29 +0100 (Thu, 21 Dec 2006) | 1 line Mention the os.SEEK_* constants ........ r53129 | walter.doerwald | 2006-12-21 19:06:30 +0100 (Thu, 21 Dec 2006) | 2 lines Fix typo. ........ r53131 | thomas.heller | 2006-12-21 19:30:56 +0100 (Thu, 21 Dec 2006) | 3 lines Fix wrong markup of an argument in a method signature. Will backport. ........ r53137 | andrew.kuchling | 2006-12-22 01:50:56 +0100 (Fri, 22 Dec 2006) | 1 line Typo fix ........ r53139 | andrew.kuchling | 2006-12-22 14:25:02 +0100 (Fri, 22 Dec 2006) | 1 line [Bug #737202; fix from Titus Brown] Make CGIHTTPServer work for scripts in sub-directories ........ r53141 | andrew.kuchling | 2006-12-22 16:04:45 +0100 (Fri, 22 Dec 2006) | 6 lines [Bug #802128] Make the mode argument of dumbdbm actually work the way it's described, and add a test for it. 2.5 bugfix candidate, maybe; arguably this patch changes the API of dumbdbm and shouldn't be added in a point-release. ........ r53142 | andrew.kuchling | 2006-12-22 16:16:58 +0100 (Fri, 22 Dec 2006) | 6 lines [Bug #802128 continued] Modify mode depending on the process umask. Is there really no other way to read the umask than to set it? Hope this works on Windows... ........ r53145 | andrew.kuchling | 2006-12-22 17:43:26 +0100 (Fri, 22 Dec 2006) | 1 line [Bug #776202] Apply Walter Doerwald's patch to use text mode for encoded files ........ r53146 | andrew.kuchling | 2006-12-22 19:41:42 +0100 (Fri, 22 Dec 2006) | 9 lines [Patch #783050 from Patrick Lynch] The emulation of forkpty() is incorrect; the master should close the slave fd. Added a test to test_pty.py that reads from the master_fd after doing a pty.fork(); without the fix it hangs forever instead of raising an exception. (<crossing fingers for the buildbots>) 2.5 backport candidate. ........ r53147 | andrew.kuchling | 2006-12-22 20:06:16 +0100 (Fri, 22 Dec 2006) | 1 line [Patch #827559 from Chris Gonnerman] Make SimpleHTTPServer redirect when a directory URL is missing the trailing slash; this lets relative links work. ........ r53149 | andrew.kuchling | 2006-12-22 20:21:27 +0100 (Fri, 22 Dec 2006) | 1 line Darn; this test works when you run test_pty.py directly, but fails when regrtest runs it (the os.read() raises os.error). I can't figure out the cause, so am commenting out the test. ........ r53150 | andrew.kuchling | 2006-12-22 22:48:19 +0100 (Fri, 22 Dec 2006) | 1 line Frak; this test also fails ........ r53153 | lars.gustaebel | 2006-12-23 17:40:13 +0100 (Sat, 23 Dec 2006) | 5 lines Patch #1230446: tarfile.py: fix ExFileObject so that read() and tell() work correctly together with readline(). Will backport to 2.5. ........ r53155 | lars.gustaebel | 2006-12-23 18:57:23 +0100 (Sat, 23 Dec 2006) | 5 lines Patch #1262036: Prevent TarFiles from being added to themselves under certain conditions. Will backport to 2.5. ........ r53159 | andrew.kuchling | 2006-12-27 04:25:31 +0100 (Wed, 27 Dec 2006) | 4 lines [Part of patch #1182394] Move the HMAC blocksize to be a class-level constant; this allows changing it in a subclass. To accommodate this, copy() now uses __class__. Also add some text to a comment. ........ r53160 | andrew.kuchling | 2006-12-27 04:31:24 +0100 (Wed, 27 Dec 2006) | 1 line [Rest of patch #1182394] Add ._current() method so that we can use the written-in-C .hexdigest() method ........ r53161 | lars.gustaebel | 2006-12-27 11:30:46 +0100 (Wed, 27 Dec 2006) | 4 lines Patch #1504073: Fix tarfile.open() for mode "r" with a fileobj argument. Will backport to 2.5. ........ r53165 | neal.norwitz | 2006-12-28 05:39:20 +0100 (Thu, 28 Dec 2006) | 1 line Remove a stray (old) macro name left around (I guess) ........ r53188 | neal.norwitz | 2006-12-29 04:01:53 +0100 (Fri, 29 Dec 2006) | 1 line SF bug #1623890, fix argument name in docstring ........ r53200 | raymond.hettinger | 2006-12-30 05:01:17 +0100 (Sat, 30 Dec 2006) | 1 line For sets with cyclical reprs, emit an ellipsis instead of infinitely recursing. ........ r53232 | brett.cannon | 2007-01-04 01:23:49 +0100 (Thu, 04 Jan 2007) | 3 lines Add EnvironmentVarGuard to test.test_support. Provides a context manager to temporarily set or unset environment variables. ........ r53235 | neal.norwitz | 2007-01-04 07:25:31 +0100 (Thu, 04 Jan 2007) | 1 line SF #1627373, fix typo in CarbonEvt. ........ r53244 | raymond.hettinger | 2007-01-04 18:53:34 +0100 (Thu, 04 Jan 2007) | 1 line Fix stability of heapq's nlargest() and nsmallest(). ........ r53249 | martin.v.loewis | 2007-01-04 22:06:12 +0100 (Thu, 04 Jan 2007) | 3 lines Bug #1566280: Explicitly invoke threading._shutdown from Py_Main, to avoid relying on atexit. Will backport to 2.5. ........ r53252 | gregory.p.smith | 2007-01-05 02:59:42 +0100 (Fri, 05 Jan 2007) | 3 lines Support linking of the bsddb module against BerkeleyDB 4.5.x (will backport to 2.5) ........ r53253 | gregory.p.smith | 2007-01-05 03:06:17 +0100 (Fri, 05 Jan 2007) | 2 lines bump module version to match supported berkeleydb version ........ r53255 | neal.norwitz | 2007-01-05 06:25:22 +0100 (Fri, 05 Jan 2007) | 6 lines Prevent crash on shutdown which can occur if we are finalizing and the module dict has been cleared already and some object raises a warning (like in a __del__). Will backport. ........ r53258 | gregory.p.smith | 2007-01-05 08:21:35 +0100 (Fri, 05 Jan 2007) | 2 lines typo fix ........ r53260 | neal.norwitz | 2007-01-05 09:06:43 +0100 (Fri, 05 Jan 2007) | 1 line Add Collin Winter for access to update PEP 3107 ........ r53262 | andrew.kuchling | 2007-01-05 15:22:17 +0100 (Fri, 05 Jan 2007) | 1 line [Bug #1622533] Make docstrings raw strings because they contain control characters (\0, \1) ........ r53264 | andrew.kuchling | 2007-01-05 16:51:24 +0100 (Fri, 05 Jan 2007) | 1 line [Patch #1520904] Fix bsddb tests to write to the temp directory instead of the Lib/bsddb/test directory ........ r53279 | brett.cannon | 2007-01-05 22:45:09 +0100 (Fri, 05 Jan 2007) | 3 lines Silence a warning from gcc 4.0.1 by specifying a function's parameter list is 'void' instead of just a set of empty parentheses. ........ r53285 | raymond.hettinger | 2007-01-06 02:14:41 +0100 (Sat, 06 Jan 2007) | 2 lines SF# 1409443: Expand comment to cover the interaction between f->f_lasti and the PREDICT macros. ........ r53286 | anthony.baxter | 2007-01-06 05:45:54 +0100 (Sat, 06 Jan 2007) | 1 line update to (c) years to include 2007 ........ r53291 | neal.norwitz | 2007-01-06 22:24:35 +0100 (Sat, 06 Jan 2007) | 1 line Add Josiah to SF for maintaining asyncore/asynchat ........ r53293 | peter.astrand | 2007-01-07 09:53:46 +0100 (Sun, 07 Jan 2007) | 1 line Re-implemented fix for #1531862 once again, in a way that works with Python 2.2. Fixes bug #1603424. ........ r53295 | peter.astrand | 2007-01-07 15:34:16 +0100 (Sun, 07 Jan 2007) | 1 line Avoid O(N**2) bottleneck in _communicate_(). Fixes #1598181. ........ r53300 | raymond.hettinger | 2007-01-08 19:09:20 +0100 (Mon, 08 Jan 2007) | 1 line Fix zero-length corner case for iterating over a mutating deque. ........ r53301 | vinay.sajip | 2007-01-08 19:50:32 +0100 (Mon, 08 Jan 2007) | 4 lines Bare except clause removed from SMTPHandler.emit(). Now, only ImportError is trapped. Bare except clause removed from SocketHandler.createSocket(). Now, only socket.error is trapped. (SF #411881) ........ r53302 | vinay.sajip | 2007-01-08 19:51:46 +0100 (Mon, 08 Jan 2007) | 2 lines Bare except clause removed from LogRecord.__init__. Now, only ValueError, TypeError and AttributeError are trapped. (SF #411881) ........ r53303 | vinay.sajip | 2007-01-08 19:52:36 +0100 (Mon, 08 Jan 2007) | 1 line Added entries about removal of some bare except clauses from logging. ........
1 parent 84f248d commit 902d6eb

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

86 files changed

+869
-407
lines changed

Doc/README

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -229,7 +229,7 @@ The Python source is copyrighted, but you can freely use and copy it
229229
as long as you don't change or remove the copyright notice:
230230

231231
----------------------------------------------------------------------
232-
Copyright (c) 2000-2006 Python Software Foundation.
232+
Copyright (c) 2000-2007 Python Software Foundation.
233233
All rights reserved.
234234

235235
Copyright (c) 2000 BeOpen.com.

Doc/api/newtypes.tex

Lines changed: 0 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -103,8 +103,6 @@ \section{Allocating Objects on the Heap
103103
the value for the \var{methods} argument]{2.3}
104104
\end{cfuncdesc}
105105

106-
DL_IMPORT
107-
108106
\begin{cvardesc}{PyObject}{_Py_NoneStruct}
109107
Object which is visible in Python as \code{None}. This should only
110108
be accessed using the \code{Py_None} macro, which evaluates to a

Doc/howto/functional.rst

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1398,10 +1398,10 @@ Python documentation
13981398
'''''''''''''''''''''''''''
13991399

14001400
http://docs.python.org/lib/module-itertools.html:
1401-
Documentation ``for the itertools`` module.
1401+
Documentation for the ``itertools`` module.
14021402

14031403
http://docs.python.org/lib/module-operator.html:
1404-
Documentation ``for the operator`` module.
1404+
Documentation for the ``operator`` module.
14051405

14061406
http://www.python.org/dev/peps/pep-0289/:
14071407
PEP 289: "Generator Expressions"

Doc/lib/libbsddb.tex

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -16,7 +16,7 @@ \section{\module{bsddb} ---
1616
\function{pickle.dumps()}.
1717

1818
The \module{bsddb} module requires a Berkeley DB library version from
19-
3.3 thru 4.4.
19+
3.3 thru 4.5.
2020

2121
\begin{seealso}
2222
\seeurl{http://pybsddb.sourceforge.net/}

Doc/lib/libbz2.tex

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -81,10 +81,10 @@ \subsection{(De)compression of files}
8181

8282
\begin{methoddesc}[BZ2File]{seek}{offset\optional{, whence}}
8383
Move to new file position. Argument \var{offset} is a byte count. Optional
84-
argument \var{whence} defaults to \code{0} (offset from start of file,
85-
offset should be \code{>= 0}); other values are \code{1} (move relative to
86-
current position, positive or negative), and \code{2} (move relative to end
87-
of file, usually negative, although many platforms allow seeking beyond
84+
argument \var{whence} defaults to \code{os.SEEK_SET} or \code{0} (offset from start of file;
85+
offset should be \code{>= 0}); other values are \code{os.SEEK_CUR} or \code{1} (move relative to
86+
current position; offset can be positive or negative), and \code{os.SEEK_END} or \code{2} (move relative to end
87+
of file; offset is usually negative, although many platforms allow seeking beyond
8888
the end of a file).
8989

9090
Note that seeking of bz2 files is emulated, and depending on the parameters

Doc/lib/libctypes.tex

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -2085,10 +2085,10 @@ \subsubsection{Data types\label{ctypes-data-types}}
20852085
the type. Some types accept other objects as well.
20862086
\end{methoddesc}
20872087
2088-
\begin{methoddesc}{in_dll}{name, library}
2088+
\begin{methoddesc}{in_dll}{library, name}
20892089
This method returns a ctypes type instance exported by a shared
20902090
library. \var{name} is the name of the symbol that exports the data,
2091-
\code{library} is the loaded shared library.
2091+
\var{library} is the loaded shared library.
20922092
\end{methoddesc}
20932093
20942094
Common instance variables of ctypes data types:

Doc/lib/libfuncs.tex

Lines changed: 37 additions & 37 deletions
Original file line numberDiff line numberDiff line change
@@ -237,11 +237,11 @@ \section{Built-in Functions \label{built-in-funcs}}
237237
\code{del \var{x}.\var{foobar}}.
238238
\end{funcdesc}
239239

240-
\begin{funcdesc}{dict}{\optional{mapping-or-sequence}}
240+
\begin{funcdesc}{dict}{\optional{arg}}
241241
Return a new dictionary initialized from an optional positional
242242
argument or from a set of keyword arguments.
243243
If no arguments are given, return a new empty dictionary.
244-
If the positional argument is a mapping object, return a dictionary
244+
If the positional argument \var{arg} is a mapping object, return a dictionary
245245
mapping the same keys to the same values as does the mapping object.
246246
Otherwise the positional argument must be a sequence, a container that
247247
supports iteration, or an iterator object. The elements of the argument
@@ -448,18 +448,18 @@ \section{Built-in Functions \label{built-in-funcs}}
448448
\versionadded{2.2}
449449
\end{funcdesc}
450450

451-
\begin{funcdesc}{filter}{function, list}
452-
Construct a list from those elements of \var{list} for which
453-
\var{function} returns true. \var{list} may be either a sequence, a
454-
container which supports iteration, or an iterator, If \var{list}
451+
\begin{funcdesc}{filter}{function, iterable}
452+
Construct a list from those elements of \var{iterable} for which
453+
\var{function} returns true. \var{iterable} may be either a sequence, a
454+
container which supports iteration, or an iterator, If \var{iterable}
455455
is a string or a tuple, the result
456456
also has that type; otherwise it is always a list. If \var{function} is
457457
\code{None}, the identity function is assumed, that is, all elements of
458-
\var{list} that are false are removed.
458+
\var{iterable} that are false are removed.
459459

460-
Note that \code{filter(function, \var{list})} is equivalent to
461-
\code{[item for item in \var{list} if function(item)]} if function is
462-
not \code{None} and \code{[item for item in \var{list} if item]} if
460+
Note that \code{filter(function, \var{iterable})} is equivalent to
461+
\code{[item for item in \var{iterable} if function(item)]} if function is
462+
not \code{None} and \code{[item for item in \var{iterable} if item]} if
463463
function is \code{None}.
464464
\end{funcdesc}
465465

@@ -608,12 +608,12 @@ \section{Built-in Functions \label{built-in-funcs}}
608608
may be a sequence (string, tuple or list) or a mapping (dictionary).
609609
\end{funcdesc}
610610

611-
\begin{funcdesc}{list}{\optional{sequence}}
611+
\begin{funcdesc}{list}{\optional{iterable}}
612612
Return a list whose items are the same and in the same order as
613-
\var{sequence}'s items. \var{sequence} may be either a sequence, a
613+
\var{iterable}'s items. \var{iterable} may be either a sequence, a
614614
container that supports iteration, or an iterator object. If
615-
\var{sequence} is already a list, a copy is made and returned,
616-
similar to \code{\var{sequence}[:]}. For instance,
615+
\var{iterable} is already a list, a copy is made and returned,
616+
similar to \code{\var{iterable}[:]}. For instance,
617617
\code{list('abc')} returns \code{['a', 'b', 'c']} and \code{list(
618618
(1, 2, 3) )} returns \code{[1, 2, 3]}. If no argument is given,
619619
returns a new empty list, \code{[]}.
@@ -639,22 +639,22 @@ \section{Built-in Functions \label{built-in-funcs}}
639639
are given, returns \code{0L}.
640640
\end{funcdesc}
641641

642-
\begin{funcdesc}{map}{function, list, ...}
643-
Apply \var{function} to every item of \var{list} and return a list
644-
of the results. If additional \var{list} arguments are passed,
642+
\begin{funcdesc}{map}{function, iterable, ...}
643+
Apply \var{function} to every item of \var{iterable} and return a list
644+
of the results. If additional \var{iterable} arguments are passed,
645645
\var{function} must take that many arguments and is applied to the
646-
items of all lists in parallel; if a list is shorter than another it
646+
items from all iterables in parallel. If one iterable is shorter than another it
647647
is assumed to be extended with \code{None} items. If \var{function}
648648
is \code{None}, the identity function is assumed; if there are
649-
multiple list arguments, \function{map()} returns a list consisting
650-
of tuples containing the corresponding items from all lists (a kind
651-
of transpose operation). The \var{list} arguments may be any kind
652-
of sequence; the result is always a list.
649+
multiple arguments, \function{map()} returns a list consisting
650+
of tuples containing the corresponding items from all iterables (a kind
651+
of transpose operation). The \var{iterable} arguments may be a sequence
652+
or any iterable object; the result is always a list.
653653
\end{funcdesc}
654654

655-
\begin{funcdesc}{max}{s\optional{, args...}\optional{key}}
656-
With a single argument \var{s}, return the largest item of a
657-
non-empty sequence (such as a string, tuple or list). With more
655+
\begin{funcdesc}{max}{iterable\optional{, args...}\optional{key}}
656+
With a single argument \var{iterable}, return the largest item of a
657+
non-empty iterable (such as a string, tuple or list). With more
658658
than one argument, return the largest of the arguments.
659659

660660
The optional \var{key} argument specifies a one-argument ordering
@@ -664,16 +664,16 @@ \section{Built-in Functions \label{built-in-funcs}}
664664
\versionchanged[Added support for the optional \var{key} argument]{2.5}
665665
\end{funcdesc}
666666

667-
\begin{funcdesc}{min}{s\optional{, args...}\optional{key}}
668-
With a single argument \var{s}, return the smallest item of a
669-
non-empty sequence (such as a string, tuple or list). With more
667+
\begin{funcdesc}{min}{iterable\optional{, args...}\optional{key}}
668+
With a single argument \var{iterable}, return the smallest item of a
669+
non-empty iterable (such as a string, tuple or list). With more
670670
than one argument, return the smallest of the arguments.
671671

672672
The optional \var{key} argument specifies a one-argument ordering
673673
function like that used for \method{list.sort()}. The \var{key}
674674
argument, if supplied, must be in keyword form (for example,
675675
\samp{min(a,b,c,key=func)}).
676-
\versionchanged[Added support for the optional \var{key} argument]{2.5}
676+
\versionchanged[Added support for the optional \var{key} argument]{2.5}
677677
\end{funcdesc}
678678

679679
\begin{funcdesc}{object}{}
@@ -1073,11 +1073,11 @@ \section{Built-in Functions \label{built-in-funcs}}
10731073
string, \code{''}.
10741074
\end{funcdesc}
10751075

1076-
\begin{funcdesc}{sum}{sequence\optional{, start}}
1077-
Sums \var{start} and the items of a \var{sequence}, from left to
1078-
right, and returns the total. \var{start} defaults to \code{0}.
1079-
The \var{sequence}'s items are normally numbers, and are not allowed
1080-
to be strings. The fast, correct way to concatenate sequence of
1076+
\begin{funcdesc}{sum}{iterable\optional{, start}}
1077+
Sums \var{start} and the items of an \var{iterable} from left to
1078+
right and returns the total. \var{start} defaults to \code{0}.
1079+
The \var{iterable}'s items are normally numbers, and are not allowed
1080+
to be strings. The fast, correct way to concatenate a sequence of
10811081
strings is by calling \code{''.join(\var{sequence})}.
10821082
\versionadded{2.3}
10831083
\end{funcdesc}
@@ -1105,11 +1105,11 @@ \section{Built-in Functions \label{built-in-funcs}}
11051105
\versionadded{2.2}
11061106
\end{funcdesc}
11071107

1108-
\begin{funcdesc}{tuple}{\optional{sequence}}
1108+
\begin{funcdesc}{tuple}{\optional{iterable}}
11091109
Return a tuple whose items are the same and in the same order as
1110-
\var{sequence}'s items. \var{sequence} may be a sequence, a
1110+
\var{iterable}'s items. \var{iterable} may be a sequence, a
11111111
container that supports iteration, or an iterator object.
1112-
If \var{sequence} is already a tuple, it
1112+
If \var{iterable} is already a tuple, it
11131113
is returned unchanged. For instance, \code{tuple('abc')} returns
11141114
\code{('a', 'b', 'c')} and \code{tuple([1, 2, 3])} returns
11151115
\code{(1, 2, 3)}. If no argument is given, returns a new empty

Doc/lib/liblogging.tex

Lines changed: 4 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -516,8 +516,10 @@ \subsection{Logger Objects}
516516
\end{methoddesc}
517517

518518
\begin{methoddesc}{findCaller}{}
519-
Finds the caller's source filename and line number. Returns the filename
520-
and line number as a 2-element tuple.
519+
Finds the caller's source filename and line number. Returns the filename,
520+
line number and function name as a 3-element tuple.
521+
\versionchanged[The function name was added. In earlier versions, the
522+
filename and line number were returned as a 2-element tuple.]{2.5}
521523
\end{methoddesc}
522524

523525
\begin{methoddesc}{handle}{record}

Doc/lib/libmmap.tex

Lines changed: 3 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -140,8 +140,9 @@ \section{\module{mmap} ---
140140

141141
\begin{methoddesc}{seek}{pos\optional{, whence}}
142142
Set the file's current position. \var{whence} argument is optional
143-
and defaults to \code{0} (absolute file positioning); other values
144-
are \code{1} (seek relative to the current position) and \code{2}
143+
and defaults to \code{os.SEEK_SET} or \code{0} (absolute file
144+
positioning); other values are \code{os.SEEK_CUR} or \code{1} (seek
145+
relative to the current position) and \code{os.SEEK_END} or \code{2}
145146
(seek relative to the file's end).
146147
\end{methoddesc}
147148

Doc/lib/libsimplexmlrpc.tex

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -15,7 +15,7 @@ \section{\module{SimpleXMLRPCServer} ---
1515

1616
\begin{classdesc}{SimpleXMLRPCServer}{addr\optional{,
1717
requestHandler\optional{,
18-
logRequests\optional{allow_none\optional{, encoding}}}}}
18+
logRequests\optional{, allow_none\optional{, encoding}}}}}
1919

2020
Create a new server instance. This class
2121
provides methods for registration of functions that can be called by

0 commit comments

Comments
 (0)