Use the :mod: role.

Some textual tweaks, and fixed a few typos found by a spell checker.

Fix bad markup.

More cleanup.  Moved all Unicode and str/bytes info to the text/data
subsection in common pitfalls, rather than spreading it out.  Made
this the last subsection of common pitfalls.  All XXX comments are now
gone.  I'm sure much is still missing, we'll have to clean that up
post 3.0.  At least all PEPs and all implemented items in PEP 3100
have at least one mention.

Another checkpoint.
(A bit of a mess, a previous submit apparently didn't go through.)

Another checkpoint -- some stuff I managed to do on the train.

Merged revisions 67484 via svnmerge from
svn+ssh://pythondev@svn.python.org/python/trunk

........
  r67484 | christian.heimes | 2008-12-03 01:53:18 +0100 (Wed, 03 Dec 2008) | 2 lines

  Issue #4025 again
  Converted a C99 style comment to a C89 style comment (found by MAL).
........

Another checkpoint.

interators -> iterators (thanks Taggnostr)

Finished what I'm going to write about the standard library.

Finished the "porting to 3.0" section.  Had to add a label to
howto/cporting.rst.

Another checkpoint.  More XXXes added...

Also add some labels to 2.6.rst and howto/unicode.rst so I can refer
to them.  (Somehow a label named 'module-contextlib' couldn't be
referenced -- why???)

Issue 3689:  list_reverseiterator should support __length_hint__ instead of __len__.

Bug #4495:  Fix signed/unsigned warning (both namelen and tailen should be signed, not just namelen).

Another checkpoint to switch machines.

Add missing bracket.

Fix typo.

Issue #4387: binascii now refuses to accept str as binary input.

Fix docutils parsing errors in Misc/NEWS.

fix markup

Checkpoint.  Added some stuff.  Mostly XXX notes for myself. :-)

Merged revisions 67467 via svnmerge from
svn+ssh://pythondev@svn.python.org/python/trunk

........
  r67467 | benjamin.peterson | 2008-12-01 13:52:51 +0100 (Mon, 01 Dec 2008) | 1 line

  let people using SVN Sphinx still build the docs
........

Add script forgotten in r67464.

Issue #4073: Add 2to3 support to build_scripts, refactor that support
in build_py.

Update copyright for recent changes.

Merged revisions 67348,67355,67359,67362,67364-67365,67367-67368,67398,67423-67424,67432,67440-67441,67444-67445,67454-67455,67457-67458 via svnmerge from
svn+ssh://pythondev@svn.python.org/python/trunk

........
  r67348 | benjamin.peterson | 2008-11-22 20:09:41 -0600 (Sat, 22 Nov 2008) | 1 line

  raise a better error
........
  r67355 | georg.brandl | 2008-11-23 13:17:25 -0600 (Sun, 23 Nov 2008) | 2 lines

  #4392: fix parameter name.
........
  r67359 | georg.brandl | 2008-11-23 15:57:30 -0600 (Sun, 23 Nov 2008) | 2 lines

  #4399: fix typo.
........
  r67362 | gregory.p.smith | 2008-11-23 18:41:43 -0600 (Sun, 23 Nov 2008) | 2 lines

  Document PY_SSIZE_T_CLEAN for PyArg_ParseTuple.
........
  r67364 | benjamin.peterson | 2008-11-23 19:16:29 -0600 (Sun, 23 Nov 2008) | 2 lines

  replace reference to debugger-hooks
........
  r67365 | benjamin.peterson | 2008-11-23 22:09:03 -0600 (Sun, 23 Nov 2008) | 1 line

  #4396 make the parser module correctly validate the with syntax
........
  r67367 | georg.brandl | 2008-11-24 10:16:07 -0600 (Mon, 24 Nov 2008) | 2 lines

  Fix typo.
........
  r67368 | georg.brandl | 2008-11-24 13:56:47 -0600 (Mon, 24 Nov 2008) | 2 lines

  #4404: make clear what "path" is.
........
  r67398 | benjamin.peterson | 2008-11-26 11:39:17 -0600 (Wed, 26 Nov 2008) | 1 line

  fix typo in sqlite3 docs
........
  r67423 | jesse.noller | 2008-11-28 12:59:35 -0600 (Fri, 28 Nov 2008) | 2 lines

  issue4238: bsd support for cpu_count
........
  r67424 | christian.heimes | 2008-11-28 13:33:33 -0600 (Fri, 28 Nov 2008) | 1 line

  Retain copyright of processing examples. This was requested by a Debian maintainer during packaging of the multiprocessing package for 2.4/2.5
........
  r67432 | benjamin.peterson | 2008-11-28 17:18:46 -0600 (Fri, 28 Nov 2008) | 1 line

  SVN format 9 is the same it seems
........
  r67440 | jeremy.hylton | 2008-11-28 17:42:59 -0600 (Fri, 28 Nov 2008) | 4 lines

  Move definition int sval into branch of ifdef where it is used.

  Otherwise, you get a warning about an undefined variable.
........
  r67441 | jeremy.hylton | 2008-11-28 18:09:16 -0600 (Fri, 28 Nov 2008) | 2 lines

  Reflow long lines.
........
  r67444 | amaury.forgeotdarc | 2008-11-28 20:03:32 -0600 (Fri, 28 Nov 2008) | 2 lines

  Fix a small typo in docstring
........
  r67445 | benjamin.peterson | 2008-11-29 21:07:33 -0600 (Sat, 29 Nov 2008) | 1 line

  StringIO.close() stops you from using the buffer, too
........
  r67454 | benjamin.peterson | 2008-11-30 08:43:23 -0600 (Sun, 30 Nov 2008) | 1 line

  note the version that works
........
  r67455 | martin.v.loewis | 2008-11-30 13:28:27 -0600 (Sun, 30 Nov 2008) | 1 line

  Issue #4365: Add crtassem.h constants to the msvcrt module.
........
  r67457 | christian.heimes | 2008-11-30 15:16:28 -0600 (Sun, 30 Nov 2008) | 1 line

  w# requires Py_ssize_t
........
  r67458 | benjamin.peterson | 2008-11-30 15:46:16 -0600 (Sun, 30 Nov 2008) | 1 line

  fix pyspecific extensions that were broken by Sphinx's grand renaming
........

Merged revisions 67442 via svnmerge from
svn+ssh://pythondev@svn.python.org/python/trunk

........
  r67442 | jeremy.hylton | 2008-11-28 19:09:35 -0600 (Fri, 28 Nov 2008) | 18 lines

  Send HTTP headers and message body in a single send() call.

  This change addresses part of issue 4336.

  Change endheaders() to take an optional message_body argument
  that is sent along with the headers.  Change xmlrpclib and
  httplib's other methods to use this new interface.

  It is more efficient to make a single send() call, which should
  get the entire client request into one packet (assuming it is
  smaller than the MTU) and will avoid the long pause for delayed
  ack following timeout.

  Also:
  - Add a comment about the buffer size for makefile().
  - Extract _set_content_length() method and fix whitespace issues there.
........

Merged revisions 67449 via svnmerge from
svn+ssh://pythondev@svn.python.org/python/trunk

........
  r67449 | martin.v.loewis | 2008-11-30 12:08:26 +0100 (So, 30 Nov 2008) | 3 lines

  Issue #4389: Add icon to the uninstall entry in
  "add-and-remove-programs".
........

Issue #4407: Fix source file that caused the compileall step in Windows
installer to fail.

Blocked revisions 67370 via svnmerge

........
  r67370 | jeremy.hylton | 2008-11-24 16:00:29 -0600 (Mon, 24 Nov 2008) | 8 lines

  Add unittests that verify documented behavior of public methods in Transport
  class.

  These methods can be overridden.  The tests verify that the overridden
  methods are called, and that changes to the connection have a visible
  effect on the request.
........

Fix more threading API related bugs: Thread.get_name() --> Thread.name.

Seen when setting RPCHandler.debugging=True

#4455: IDLE failed to display the windows list when two windows have the same title.

Windows objects cannot be compared, and it's better to have a consistent order;
so We add the window unique ID to the sort key.

Reviewed by Benjamin Peterson.

Merged revisions 67428 via svnmerge from
svn+ssh://pythondev@svn.python.org/python/trunk

................
  r67428 | benjamin.peterson | 2008-11-28 16:12:14 -0600 (Fri, 28 Nov 2008) | 57 lines

  Merged revisions 67384,67386-67387,67389-67390,67392,67399-67400,67403-67405,67426 via svnmerge from
  svn+ssh://pythondev@svn.python.org/sandbox/trunk/2to3/lib2to3

  ........
    r67384 | benjamin.peterson | 2008-11-25 16:13:31 -0600 (Tue, 25 Nov 2008) | 4 lines

    don't duplicate calls to start_tree()

    RefactoringTool.pre_order values now holds a list of the fixers while pre_order_mapping holds the dict.
  ........
    r67386 | benjamin.peterson | 2008-11-25 16:44:52 -0600 (Tue, 25 Nov 2008) | 1 line

    #4423 fix_imports was still replacing usage of a module if attributes were being used
  ........
    r67387 | benjamin.peterson | 2008-11-25 16:47:54 -0600 (Tue, 25 Nov 2008) | 1 line

    fix broken test
  ........
    r67389 | benjamin.peterson | 2008-11-25 17:13:17 -0600 (Tue, 25 Nov 2008) | 1 line

    remove compatibility code; we only cater to 2.5+
  ........
    r67390 | benjamin.peterson | 2008-11-25 22:03:36 -0600 (Tue, 25 Nov 2008) | 1 line

    fix #3994; the usage of changed imports was fixed in nested cases
  ........
    r67392 | benjamin.peterson | 2008-11-26 11:11:40 -0600 (Wed, 26 Nov 2008) | 1 line

    simpilfy and comment fix_imports
  ........
    r67399 | benjamin.peterson | 2008-11-26 11:47:03 -0600 (Wed, 26 Nov 2008) | 1 line

    remove more compatibility code
  ........
    r67400 | benjamin.peterson | 2008-11-26 12:07:41 -0600 (Wed, 26 Nov 2008) | 1 line

    set svn:ignore
  ........
    r67403 | benjamin.peterson | 2008-11-26 13:11:11 -0600 (Wed, 26 Nov 2008) | 1 line

    wrap import
  ........
    r67404 | benjamin.peterson | 2008-11-26 13:29:49 -0600 (Wed, 26 Nov 2008) | 1 line

    build the fix_imports pattern in compile_pattern, so MAPPING can be changed and reflected in the pattern
  ........
    r67405 | benjamin.peterson | 2008-11-26 14:01:24 -0600 (Wed, 26 Nov 2008) | 1 line

    stop ugly messages about runtime errors being from printed
  ........
    r67426 | benjamin.peterson | 2008-11-28 16:01:40 -0600 (Fri, 28 Nov 2008) | 5 lines

    don't replace a module name if it is in the middle of a attribute lookup

    This fix also stops module names from being replaced if they are not in an attribute lookup.
  ........
................

Blocked revisions 67349,67353,67396,67407,67411 via svnmerge

........
  r67349 | matthias.klose | 2008-11-23 07:37:03 -0600 (Sun, 23 Nov 2008) | 3 lines

   - Modules/Setup.dist: Mention _functools in section "Modules that should
     always be present (non UNIX dependent)"
........
  r67353 | matthias.klose | 2008-11-23 07:54:42 -0600 (Sun, 23 Nov 2008) | 2 lines

  - Fix typo in last checkin
........
  r67396 | matthias.klose | 2008-11-26 11:32:49 -0600 (Wed, 26 Nov 2008) | 2 lines

  - Modules/Setup.dist: Mention _elementtree and _pickle.
........
  r67407 | matthias.klose | 2008-11-27 01:45:25 -0600 (Thu, 27 Nov 2008) | 2 lines

  - Modules/Setup.dist: Update pyexpat
........
  r67411 | matthias.klose | 2008-11-27 04:14:22 -0600 (Thu, 27 Nov 2008) | 2 lines

  - Modules/Setup.dist: Update _elementtree, add _bisect, datetime
........

Fix mp example, remove fix_logger call

Merge r67419 to py3k, mp doc fixes

Forgot to update Misc/NEWS

2to3 run of multiprocessing examples.
mp_benchmarks, mp_newtypes and mp_distribution are still broken but the others are working properly. We should include the examples in our unit test suite ...

Merged revisions 67414 via svnmerge from
svn+ssh://pythondev@svn.python.org/python/trunk

........
  r67414 | christian.heimes | 2008-11-28 12:02:32 +0100 (Fri, 28 Nov 2008) | 1 line

  Fixed issue ##3741: DISTUTILS_USE_SDK set causes msvc9compiler.py to raise an exception
........

- Modules/Setup.dist: Add _bisect

- Modules/Setup.dist: add datetime, update _elementtree

- Modules/Setup.dist: Update pyexpat

Remove the Py_TPFLAGS_HAVE_GC from the _ctypes.COMError type.
Fixes issue #4433; reviewed by Benjamin Peterson.

- Modules/Setup.dist: Fix typo in last checkin

- Modules/Setup.dist: Mention _elementtree and _pickle.

- Fix build failure of _cursesmodule.c building with -D_FORTIFY_SOURCE=2.

- fix build failure in Modules/fpectlmodule.c (not built by default)

Prevent UnicodeDecodeErrors in ctypes with non-ascii error messages.
Fixes issue #4429.

Reviewed by Amaury Forgeot d'Arc.

check the return value of NEW_IDENTIFIER in some more places

Fix a broken test_dbm_gnu as introducted by r67380.

Second fix for issue #4373

#4373: Reference leak in the pickle module.

Reviewed by Brett Cannon.

dbm.gnu and dbm.ndbm accept both strings and bytes as keys and values. For the
former they are converted to bytes before being written to the DB.

Closes issue 3799. Reviewed by Skip Montanaro.

Make ast.c compile on Windows again.

Blocked revisions 67376 via svnmerge

................
  r67376 | benjamin.peterson | 2008-11-24 22:07:45 -0600 (Mon, 24 Nov 2008) | 17 lines

  Merged revisions 67183,67191,67371 via svnmerge from
  svn+ssh://pythondev@svn.python.org/sandbox/trunk/2to3/lib2to3

  ........
    r67183 | benjamin.peterson | 2008-11-10 21:51:33 -0600 (Mon, 10 Nov 2008) | 1 line

    handle 'import x as y' in fix_imports; this still needs more work...
  ........
    r67191 | benjamin.peterson | 2008-11-11 17:24:51 -0600 (Tue, 11 Nov 2008) | 1 line

    super() is good
  ........
    r67371 | benjamin.peterson | 2008-11-24 16:02:00 -0600 (Mon, 24 Nov 2008) | 1 line

    don't blow up in the metaclass fixer when assignments in the class statement aren't simple
  ........
................

Merged revisions 67373 via svnmerge from
svn+ssh://pythondev@svn.python.org/python/trunk

........
  r67373 | benjamin.peterson | 2008-11-24 21:43:14 -0600 (Mon, 24 Nov 2008) | 2 lines

  always check the return value of NEW_IDENTIFIER
........

Merged revisions 67183,67191,67371 via svnmerge from
svn+ssh://pythondev@svn.python.org/sandbox/trunk/2to3/lib2to3

........
  r67183 | benjamin.peterson | 2008-11-11 04:51:33 +0100 (Di, 11 Nov 2008) | 1 line

  handle 'import x as y' in fix_imports; this still needs more work...
........
  r67191 | benjamin.peterson | 2008-11-12 00:24:51 +0100 (Mi, 12 Nov 2008) | 1 line

  super() is good
........
  r67371 | benjamin.peterson | 2008-11-24 23:02:00 +0100 (Mo, 24 Nov 2008) | 1 line

  don't blow up in the metaclass fixer when assignments in the class statement aren't simple
........

dbm.dumb was opening files without specifying the encoding. Caused problem on
at least OS X where the default is macroman.

Closes issue #4382.

Document PY_SSIZE_T_CLEAN use and behavior for PyArg_ParseTuple and
mention that it will become the default in a future python version.

- Fix typo in last checkin

Merge 67349 from the trunk:
- Modules/Setup.dist: Mention _functools in section "Modules that should
  always be present (non UNIX dependent)"

remove warning about not accepting unicode

I don't know if it actually works with unicode, though...

These files used to belong to the "sv" module, which was deleted.

Merged revisions 67295,67301-67302,67318,67330,67342-67343 via svnmerge from
svn+ssh://pythondev@svn.python.org/python/trunk

........
  r67295 | benjamin.peterson | 2008-11-20 05:05:12 +0100 (jeu., 20 nov. 2008) | 1 line

  move useful sys.settrace information to the function's documentation from the debugger
........
  r67301 | benjamin.peterson | 2008-11-20 22:25:31 +0100 (jeu., 20 nov. 2008) | 1 line

  fix indentation and a sphinx warning
........
  r67302 | benjamin.peterson | 2008-11-20 22:44:23 +0100 (jeu., 20 nov. 2008) | 1 line

  oops! didn't mean to disable that test
........
  r67318 | amaury.forgeotdarc | 2008-11-21 23:05:48 +0100 (ven., 21 nov. 2008) | 4 lines

  #4363: Let uuid.uuid1() and uuid.uuid4() run even if the ctypes module is not present.

  Will backport to 2.6
........
  r67330 | georg.brandl | 2008-11-22 09:34:14 +0100 (sam., 22 nov. 2008) | 2 lines

  #4364: fix attribute name on ctypes object.
........
  r67342 | amaury.forgeotdarc | 2008-11-22 20:39:38 +0100 (sam., 22 nov. 2008) | 3 lines

  yuvconvert.c is a part of the "sv" module, an old IRIX thing
  and certainly not useful for any Windows build.
........
  r67343 | amaury.forgeotdarc | 2008-11-22 21:01:18 +0100 (sam., 22 nov. 2008) | 5 lines

  #3996: On Windows, PyOS_CheckStack is supposed to protect the interpreter from
  stack overflow. But doing this, it always crashes when the stack is nearly full.

  Reviewed by Martin von Loewis. Will backport to 2.6.
........

Blocked revisions 67307 via svnmerge

........
  r67307 | amaury.forgeotdarc | 2008-11-20 17:34:31 -0600 (Thu, 20 Nov 2008) | 9 lines

  Fixed issue #4233.
  Changed semantic of _fileio.FileIO's close()  method on file objects with closefd=False.
  The file descriptor is still kept open but the file object behaves like a closed file.
  The FileIO  object also got a new readonly attribute closefd.

  Approved by Barry

  Backport of r67106 from the py3k branch
........

Add 3.0rc3 UUID.

#4153: finish updating Unicode HOWTO for Py3k changes.

Blocked revisions 67336 via svnmerge

........
  r67336 | georg.brandl | 2008-11-22 11:08:50 +0100 (Sat, 22 Nov 2008) | 2 lines

  Fix error about "-*-" being mandatory in coding cookies.
........

Fix two mp doc issues from #4012.

#4206: fix 2.xisms in multiprocessing docs and docstrings.

Blocked revisions 67332 via svnmerge

........
  r67332 | georg.brandl | 2008-11-22 09:45:33 +0100 (Sat, 22 Nov 2008) | 2 lines

  Fix typo.
........

#4372: add bullet point for __cmp__ removal.

#4361: fix string.py docstring, clarify that only ASCII characters are in its constants.

#4378: fix a few functional HOWTO 2.xisms.

Blocked revisions 67326 via svnmerge

........
  r67326 | benjamin.peterson | 2008-11-21 19:59:15 -0600 (Fri, 21 Nov 2008) | 1 line

  backport r67325: make FileIO.mode always contain 'b'
........

make FileIO.mode always include 'b'

#4386 Reviewed by Amaury

add a glossary entry for "view"

#4383: UnboundLocalError when IDLE cannot connect to its subprocess.

Python 3.0 clears the exception variable upon exit of the "except:" clause,
and the displaying code fails miserably.

Reviewed by Benjamin.

Merged revisions 67320 via svnmerge from
svn+ssh://pythondev@svn.python.org/python/trunk

........
  r67320 | benjamin.peterson | 2008-11-21 16:27:24 -0600 (Fri, 21 Nov 2008) | 4 lines

  don't segfault when \N escapes are used and unicodedata fails to load

  Fixes #4367
........

A few tiny improvements that I had sitting in an edit buffer.  More to come.
Much, much more. :-)

post-3.0rc3

Fix minor typos.

Tagging 3.0rc3.

Bump to 3.0rc3

a few updates to the gloassary with regards to __future__ and division

Make dbm.dumb encode strings as UTF-8. Also fix it so it accepts bytes and
strings.

Closes issue #3799.

fix test_gzip

#4338: Fix the distutils "setup.py upload" command.
The code still mixed bytes and strings.

Reviewed by Martin von Loewis.

Follow-up of r67300: correct a failure in socket.makefile().
SocketIO objects now always have 'name' and 'mode' attributes.

Blocked revisions 67303 via svnmerge

........
  r67303 | benjamin.peterson | 2008-11-20 16:06:22 -0600 (Thu, 20 Nov 2008) | 1 line

  backport r67300
........

fix Sphinx table warning

Fix for bug 4362 "FileIO object in io module";  Patch by amaury.forgeotdarc.

Fix for bug 4360 "SystemError when method has both super() & closure".  Patch
by amaury.forgeotdarc and reviewed by brett.cannon.

Also add release notes about the known problems with the email package.

Issue #4354: Fix distutils register command.

Merged revisions 67243,67245,67277-67278,67289 via svnmerge from
svn+ssh://pythondev@svn.python.org/python/trunk

........
  r67243 | benjamin.peterson | 2008-11-17 15:39:05 -0600 (Mon, 17 Nov 2008) | 1 line

  a few fixes on the download page
........
  r67245 | benjamin.peterson | 2008-11-17 16:05:19 -0600 (Mon, 17 Nov 2008) | 1 line

  improve __hash__ docs
........
  r67277 | skip.montanaro | 2008-11-18 21:35:41 -0600 (Tue, 18 Nov 2008) | 1 line

  patch from issue 1108
........
  r67278 | georg.brandl | 2008-11-19 01:59:09 -0600 (Wed, 19 Nov 2008) | 2 lines

  Try to fix problems with verbatim.
........
  r67289 | brett.cannon | 2008-11-19 14:29:39 -0600 (Wed, 19 Nov 2008) | 2 lines

  Ignore .pyc and .pyo files.
........

Merged revisions 67291 via svnmerge from
svn+ssh://pythondev@svn.python.org/python/trunk

........
  r67291 | benjamin.peterson | 2008-11-19 15:49:09 -0600 (Wed, 19 Nov 2008) | 5 lines

  make sure that bytearray methods return a new bytearray even if there is no change

  Fixes #4348
  Reviewed by Brett
........

Blocked revisions 67287 via svnmerge

........
  r67287 | josiah.carlson | 2008-11-19 12:26:12 -0600 (Wed, 19 Nov 2008) | 2 lines

  Fix for issue 4332 in trunk.
........

This fixes issue 4332 for Py3k.

Merged revisions 67283 via svnmerge from
svn+ssh://pythondev@svn.python.org/python/trunk

........
  r67283 | martin.v.loewis | 2008-11-19 14:51:44 +0100 (Mi, 19 Nov 2008) | 1 line

  Issue #4289: Remove Cancel button from AdvancedDlg.
........

Merged revisions 67279 via svnmerge from
svn+ssh://pythondev@svn.python.org/python/trunk

........
  r67279 | martin.v.loewis | 2008-11-19 10:09:41 +0100 (Mi, 19 Nov 2008) | 2 lines

  Issue #4116: Resolve member name conflict in ScrolledCanvas.__init__
........