Fix markup and grammatical errors. Backport from trunk

backport of revision 52644

backport: note that user can control directory location even if default dir is used

Backport 52621:
Bug #1588287: fix invalid assertion for `1,2` in debug builds.

Patch #1060577: Extract list of RPM files from spec file in
bdist_rpm

Fix code example by adding a missing import.

Fixes #1557890.

Backported from trunk.

Replace the XXX marker in the 'Arrays and pointers' reference manual
section with a link to the tutorial sections.

Backported from trunk.

Fix refleak

Bug #1576657: when setting a KeyError for a tuple key, make sure that
the tuple isn't used as the "exception arguments tuple".
 (backport from rev. 52535)

Bug #1586773: extend hashlib docstring.
 (backport from rev. 52532)

I thought I had already fixed this error in the test.

Bug #1586613: fix zlib and bz2 codecs' incremental en/decoders.
 (backport from rev. 52529)

Fix the new EncodedFile test to work with big endian platforms.
 (backport from rev. 52527)

Patch #1583880: fix tarfile's problems with long names and posix/
GNU modes.
 (backport from rev. 52524)

Bug #1357915: allow all sequence types for shell arguments in
subprocess.
 (backport from rev. 52522)

Fix codecs.EncodedFile which did not use file_encoding in 2.5.0, and
fix all codecs file wrappers to work correctly with the "with"
statement (bug #1586513).
 (backport from rev. 52517)

From SF 1557890, fix problem of using wrong type in example.

Backport 52506:
Don't inline Py_ADDRESS_IN_RANGE with gcc 4+ either.

Backport 52505:
Prevent crash if alloc of garbage fails.  Found by Typo.pl.

Backport 52504:
Fix bug #1565514, SystemError not raised on too many nested blocks.
It seems like this should be a different error than SystemError, but
I don't have any great ideas and SystemError was raised in 2.4 and earlier.

Backport 52503:
Fix crash in test on HP-UX.  Apparently, it's not possible to delete a lock if
it's held (even by the current thread).

Backport 52502:
Fix warnings with HP's C compiler.  It doesn't recognize that infinite
loops are, um, infinite.  These conditions should not be able to happen.

Backport 52501:
Add some asserts.  In sysmodule, I think these were to try to silence
some warnings from Klokwork.  They verify the assumptions of the format
of svn version output.

The assert in the thread module helped debug a problem on HP-UX.

Fix nth() itertool recipe.
 (backport from rev. 52497)

Patch #1552024: add decorator support to unparse.py demo script.
 (backport from rev. 52488)

WindowsError.str should display the windows error code,
not the posix error code; with test.
Fixes #1576174.

Backported from trunk, revision 52485.

[Patch #1574068 by Scott Dial] urllib and urllib2 were using
base64.encodestring() for encoding authentication data.
encodestring() can include newlines for very long input, which
produced broken HTTP headers.

2.4 backport candidate, probably.

[Bug #1575506] The _singlefileMailbox class was using the wrong file object in its flush() method, causing an error

[Bug #1576241] Let functools.wraps work with built-in functions

Point users to the subprocess module in the docs for os.system, os.spawn*, os.popen2, and the popen2 and commands modules

[Bug #1542016] Report PCALL_POP value.  This makes the return value of sys.callstats() match its docstring.

Backport candidate.  Though it's an API change, this is a pretty obscure
portion of the API.

[Bug #1562583] Mention the set_reuse_addr() method

[Bug #1583946] Reword description of server and issuer

[Bug #1585690] Note that line_num was added in Python 2.5

Get DBL_MAX from float.h not values.h.

Check for values.h.

[Backport of r52452]
Patch #1549049: Rewrite type conversion in structmember.
Fixes #1545696 and #1566140.

The new warnings have been omitted in the backport.

[Bug #1579796] Wrong syntax for PyDateTime_IMPORT in documentation.  Reported by David Faure.

Patch [ 1583506 ] tarfile.py: 100-char filenames are truncated
 (backport from rev. 52431)

Remove passwd.adjunct.byname from list of maps
for test_nis.

- Patch #1560695: Add .note.GNU-stack to ctypes' sysv.S so that
  ctypes isn't considered as requiring executable stacks.

Patch #1580872: Remove duplicate declaration of PyCallable_Check.

Recorded merge of revisions 51379-51603,51606-52365 via svnmerge from
svn+ssh://pythondev@svn.python.org/python/trunk/Modules/_ctypes

........
  r51379 | thomas.heller | 2006-08-18 16:38:46 +0200 (Fr, 18 Aug 2006) | 6 lines

  Add asserts to check for 'impossible' NULL values, with comments.
  In one place where I'n not 1000% sure about the non-NULL, raise
  a RuntimeError for safety.

  This should fix the klocwork issues that Neal sent me.  If so,
  it should be applied to the release25-maint branch also.
........
  r51401 | neal.norwitz | 2006-08-19 06:23:04 +0200 (Sa, 19 Aug 2006) | 4 lines

  Move assert to after NULL check, otherwise we deref NULL in the assert.

  Klocwork #307
........
  r51819 | thomas.heller | 2006-09-07 20:56:28 +0200 (Do, 07 Sep 2006) | 5 lines

  Anonymous structure fields that have a bit-width specified did not work,
  and they gave a strange error message from PyArg_ParseTuple:
      function takes exactly 2 arguments (3 given).

  With tests.
........
  r51820 | thomas.heller | 2006-09-07 21:09:54 +0200 (Do, 07 Sep 2006) | 4 lines

  The cast function did not accept c_char_p or c_wchar_p instances
  as first argument, and failed with a 'bad argument to internal function'
  error message.
........
  r52365 | thomas.heller | 2006-10-17 21:30:48 +0200 (Di, 17 Okt 2006) | 6 lines

  ctypes callback functions only support 'fundamental' result types.
  Check this and raise an error when something else is used - before
  this change ctypes would hang or crash when such a callback was
  called.  This is a partial fix for #1574584.

  Will backport to release25-maint.
........

Initialized merge tracking via "svnmerge" with revisions "1-51333" from
svn+ssh://pythondev@svn.python.org/python/trunk/Modules/_ctypes

(This had to be done with the command line:

  svnmerge init -r 1:51333 -F c:\svn\trunk\Modules\_ctypes

because svnmerge isn't able to deduce the branch point r51333 and the
HEAD URL automatically in a subdirectory.)

[Bug #1576348] Fix typo in example

C:\Code\python>type c.txt
Merge rev 52377 from trunk:

newIobject():  repaired incorrect cast to quiet MSVC warning.

ctypes callback functions only support 'fundamental' result types.
Check this and raise an error when something else is used - before
this change ctypes would hang or crash when such a callback was
called.  This is a partial fix for #1574584.

Backported from trunk.

Forward-port r52358:
- Bug #1578513: Cross compilation was broken by a change to configure.
Repair so that it's back to how it was in 2.4.3.

Remove obsolete file.

Patch #1457736: Update VC6 to use current PCbuild settings.

Mention the bdist_msi module.

Remove binary property on project files, set eol-style
to CRLF instead.

Bug #1567666: Emulate GetFileAttributesExA for Win95.

Patch #1577551: Add ctypes and ET build support for VC6.

Patch #1576954: Update VC6 build directory; remove redundant
files in VC7.1 pythoncore.vcproj.

Fix tarfile depending on buggy int('1\0', base) behavior.
 (backport from rev. 52313)

Small grammar fix, thanks Sjoerd.
 (backport from rev. 52311)

Bug #1560114: the Mac filesystem does have accurate information
about the case of filenames.
 (backport from rev. 52309)

Add a note to fpectl docs that it's not built by default
(bug #1556261).
 (backport from rev. 52307)

Bug #1545497: when given an explicit base, int() did ignore NULs
embedded in the string to convert.
 (backport from rev. 52305)

Bug #1546628: add a note about urlparse.urljoin() and absolute paths.
 (backport from rev. 52303)

Bug #1548891: The cStringIO.StringIO() constructor now encodes unicode
arguments with the system default encoding just like the write()
method does, instead of converting it to a raw buffer.
 (backport from rev. 52301)

Bug #1550524: better heuristics to find correct class definition
in inspect.findsource().
 (backport from rev. 52299)

Bug #1565919: document set types in the Language Reference.
 (backport from rev. 52297)

Bug #813342: Start the IDLE subprocess with -Qnew if the parent
is started with that option.
 (backport from rev. 52295)

Bug #1575746: fix typo in property() docs.
 (backport from rev. 52293)

Macosx: fix permission problem in generated installer

Bug #1565150: Fix subsecond processing for os.utime on Windows.

List gc.get_count() in the module docstring.

Patch #1572724: fix typo ('=' instead of '==') in _msi.c.
 (backport from rev. 52251)

[Bug #1545341] Let the 'classifiers' parameter be a tuple as well as a list.

Backport of r52238

Backport of r52236

Backport libcsv.tex bugfix from rev 52218. (SF ticket 1572471)

Backport of r52233

Backport of r52229

Backport of r52227.

Backport from trunk r52223:

Bug #1572832: fix a bug in ISO-2022 codecs which may cause segfault
when encoding non-BMP unicode characters.  (Submitted by Ray Chason)

Fix #1569998: no break inside try statement (outside loop) allowed.
  (backport from rev. 52129)

Patch #1542451: fix crash with continue in nested try/finally
  (backport from rev. 51439)

Backport the .sln and .vcproj files for PCBuild8 from the python trunk to the 2.5 maintainance branch.  This fixes build problems with visual studio 2005, and cleans up profile guided optimization.

Fix name.

Case fixes

- update links
- remove Sleepycat name now that they have been bought

[Backport to 2-5maint of r52147 | andrew.kuchling ; the buildbots seem OK
 with this change.]

Cause a PyObject_Malloc() failure to trigger a MemoryError, and then
add 'if (PyErr_Occurred())' checks to various places so that NULL is
returned properly.

Forward-port of r52136: a review of overflow-detecting code.

* unified the way intobject, longobject and mystrtoul handle
  values around -sys.maxint-1.

* in general, trying to entierely avoid overflows in any computation
  involving signed ints or longs is extremely involved.  Fixed a few
  simple cases where a compiler might be too clever (but that's all
  guesswork).

* more overflow checks against bad data in marshal.c.

* 2.5 specific: fixed a number of places that were still confusing int
  and Py_ssize_t.  Some of them could potentially have caused
  "real-world" breakage.

* list.pop(x): fixing overflow issues on x was messy.  I just reverted
  to PyArg_ParseTuple("n"), which does the right thing.  (An obscure
  test was trying to give a Decimal to list.pop()... doesn't make
  sense any more IMHO)

* trying to write a few tests...

Compilation problem caused by conflicting typedefs for uint32_t
(unsigned long vs. unsigned int).

Fix integer negation and absolute value to not rely
on undefined behaviour of the C compiler anymore.

decode_rfc2231(): As Christian Robottom Reis points out, it makes no sense to
test for parts > 3 when we use .split(..., 2).

Guard uintptr_t test with HAVE_STDINT_H, test for
stdint.h.

Fix test for uintptr_t. Fixes #1568842.

Bug #1546052: clarify that PyString_FromString(AndSize) copies the
string pointed to by its parameter.
 (backport from rev. 52078)

Bug #1446043: correctly raise a LookupError if an encoding name given
to encodings.search_function() contains a dot.
 (backport from rev. 52075)

Bug #1556784: allow format strings longer than 127 characters in
datetime's strftime function.
 (backport from rev. 52072)

Bug #1560617: in pyclbr, return full module name not only for classes,
but also for functions.
 (backport from rev. 52069)

Bug #1566602: correct failure of posixpath unittest when $HOME ends
with a slash.
 (backport from rev. 52065)

Bug #1566663: remove obsolete example from datetime docs.
 (backport from rev. 52063)

Bug #1566800: make sure that EnvironmentError can be called with any
number of arguments, as was the case in Python 2.4.
 (backport from rev. 52061)

Patch #1567691: super() and new.instancemethod() now don't accept
keyword arguments any more (previously they accepted them, but didn't
use them).
 (backport from rev. 52058)

Bug #1565661: in webbrowser, split() the command for the default
GNOME browser in case it is a command with args.
 (backport from rev. 52056)