Add various items

Patch #970015: Replace - by _ in version and release.

Patch #970019: Include version and release in the BuildRoot.

Patch #736857, #736859: Add -e option to build_scripts.

Patch #798244: More urllib2 examples.

Patch #1014992: Never return more than a line from readline.
Will backport to 2.3.

Patch #1015021: Stop claiming that coerce can return None.
Will backport to 2.3.

Back out 1.289, which breaks platforms needing addrinfo.h, and
1.293, 1.298, and 1.300, which have tried to fix this for specific
platforms.

Simplify chains of conditional jumps.
(Suggested by Neal Norwitz.)

Ah whoops, we didn't turn string into a package (thanks Neal!)

PEP 292 classes Template and SafeTemplate are added to the string module.
This patch includes test cases and documentation updates, as well as NEWS file
updates.

This patch also updates the sre modules so that they don't import the string
module, breaking direct circular imports.

Stop producing or using OverflowWarning.  PEP 237 thought this would
happen in 2.3, but nobody noticed it still was getting generated (the
warning was disabled by default).  OverflowWarning and
PyExc_OverflowWarning should be removed for 2.5, and left notes all over
saying so.

SF #1015517, get readline to compile with older compilers

Fix for [ 1010677 ] thread Module Breaks PyGILState_Ensure(),
and a test case.
When booting a new thread, use the PyGILState API to manage the GIL.

Keep option parser from gobbling up the filename to be profiled and the
flags it accepts.  It's too late to change optparse's default behavior now,
but I find the default setting of allow_interspersed_args very weird.

Fixed bug in DatagramHandler.send()

Incorporate review comments courtesy of Neal Norwitz:
* Perform the code length check earlier.
* Eliminate the extra PyMem_Free() upon hitting an EXTENDED_ARG.
* Assert that the NOP count used in jump retargeting matches the NOPs
  eliminated in the final step.
* Add an XXX note to indicate that more work is being to done to
  handle linenotab with intervals > 255.

SF Patch #1013667:  Cleanup Peepholer Output

* Make a pass to eliminate NOPs.  Produce code that is more readable,
  more compact, and a tiny bit faster.  Makes the peepholer more flexible
  in the scope of allowable transformations.

* With Guido's okay, bumped up the magic number so that this patch gets
  widely exercised before the alpha goes out.

Add Nick Coghlan for his patch solving an issue with joining string
subclasses.

SF Patch #1007087:  Return new string for single subclass joins (Bug #1001011)
(Patch contributed by Nick Coghlan.)

Now joining string subtypes will always return a string.
Formerly, if there were only one item, it was returned unchanged.

The attempt to shut up deprecation warnings for doctest's own use of
is_private in its tests failed if doctest.py was run directly.  Now
it works.

test_DocTestFinder():  This test failed when test_doctest was run
directly, due to assuming a filename specific to running tests "the
normal way".  +ELLIPSIS to the rescue!

Moved some test cases from doctest to test_doctest.

Misc cleanups.

debug_script():  I changed this in haste before to take out the use of
NamedTemporaryFile (which can't work for this function's purposes on
Windows).  Leaving temp files behind wasn't a great idea either, though,
so try to clean up.  At least the test suite no longer leaves any of
these guys behind now.

Patch #1014237: Consistently return booleans throughout.

Updated the socketpair() docstring and documentation to explain that the
default famility is AF_UNIX if defined for the platform, otherwise the
default is AF_INET.

Removed unnecessary calls to signal() to ignore SIGPIPE.  SIGPIPE is ignored
in initsigs() inside pythonrun.c.

Removed redundant versionadded{} for NDIFF_DIFF.  Virtually everything
in this section is new in 2.4, and that's all mentioned already in
versionadded{} thingies at the end of the section.  It hurts readability
to have them after every line <wink>.

Add version info

Flush bz2 data even if nothing had been written so far. Fixes #1013882.
Will backport to 2.3.

Fix repr for negative imaginary part. Fixes #1013908.

Start deferring to the LaTeX docs for details.  I'd like to move the
docstrings toward being a lot shorter, and telling the whole truth in
the manual instead.  This change is an example:  the manual has detailed
explanations of the option names now, so it's Bad to repeat them in
the docstring (two detailed descriptions are certain to get out of synch).
Just listing the names has memory-jogging benefits, though, so that's
still helpful in the docstring.

Added NDIFF_DIFF option.

Whitespace normalization.

Type in docstring.

_parse_example():  Simplified new code to preserve trailing spaces before
final newline.  Anything to get rid of "l" as a variable name <0.5 wink>.

Add acknowledgements to ExitDialog.

Patch #997284: Allow pydoc to work with XP Themes (.manifest file)
Will backport to 2.3.

Patch #1009389: Make __credits__ a Unicode object.

Replace yield with sequence class. Fixes #1009803.

SF bug #1013760: Error in Chapter 4 of Tutorial

Fit a nit.

Bugs fixed:

  - Test filenames sometimes had trailing .pyc or .pyo sufixes
    (when module __file__ did).

  - Trailing spaces spaces in expected output were dropped.

New default failure format:

  - Separation of examples from file info makes examples easier to see

  - More vertical separation, improving readability

  - Emacs-recognized file info (also closer to Python exception format)

Move msi from sandbox to Tools.

1. If user passes a non-existant filename on the commandline, just open
   a new file, don't raise a dialog.  IDLEfork 954928.
2. Refactor EditorWindow.wakeup() to WindowList.ListedToplevel.wakeup() and
   clarify that the Toplevel of an EditorWindow is a WindowList.ListedToplevel.
3. Make a number of improvements to keyboard focus binding.  Improve window
   raising, especially in the debugger.  IDLEfork Bug 763524 (GvR list).
4. Bump idlever to 1.1a3

M Debugger.py
M EditorWindow.py
M FileList.py
M NEWS.txt
M PyShell.py
M WindowList.py
M idlever.py

_ellipsis_match():  Removed special-casing of "...\n".  The semantics
are non-obvious either way because the newline character "is invisible",
but it's still there all the same, and it's easier to explain/predict
if that reality is left alone.

sf #1009373, #1005936. fix underscores in index entries in PDF files.
I couldn't test this, but it didn't break anything and the patch
reported fixed the problem.

Bugfix candidate.

Patch #880621: the last message of a Babyl mailbox ends in '\037' instead of
'\037\014\n' (see http://quimby.gnus.org/notes/BABYL) so look for that as well,
so that applications won't get '\037' as the last line of the last message.

Patch #1011123: Use urllib.quote() instead of cgi.escape() for encoding the
href attribute in list_directory(). This fixes the links for legal Unix
filenames such as 'a"b'.

Patch 1012740:  cStringIO's truncate doesn't

truncate() left the stream position unchanged, which meant the
"truncated" data didn't go away:

>>> io.write('abc')
>>> io.truncate(0)
>>> io.write('xyz')
>>> io.getvalue()
'abcxyz'

Patch by Dima Dorfman.

Fix grammar, spotted by Hye-Shik Chang

Correct argument specifications of load_compiled and load_source: the file
argument is optional on both (the format string is "ss|O!").

Quote # as \# to make lib compile again.

Bump minimum Python version to 2.1. Fixes #1009803.

Replace tricky and/or with straight-forward if:else:

Fail fatally if strdup fails.

Remove debug print.

Whitespace normalization.

Stab at SF 1010777:  test_queue fails occasionally

test_queue has failed occasionally for years, and there's more than one
cause.

The primary cause in the SF report appears to be that the test driver
really needs entirely different code for thread tests that expect to
raise exceptions than for thread tests that are testing non-exceptional
blocking semantics.  So gave them entirely different code, and added a
ton of explanation.

Another cause is that the blocking thread tests relied in several places
on the difference between sleep(.1) and sleep(.2) being long enough for
the trigger thread to do its stuff sot that the blocking thread could make
progress.  That's just not reliable on a loaded machine.  Boosted the 0.2's
to 10.0's instead, which should be long enough under any non-catastrophic
system conditions.  That doesn't make the test take longer to run, the 10.0
is just how long the blocking thread is *willing* to wait for the trigger
thread to do something.  But if the Queue module is plain broken, such
tests will indeed take 10 seconds to fail now.

For similar (heavy load) reasons, changed threaded-test termination to
be willing to wait 10 seconds for the signal thread to end too.

Semantic-neutral format and comment changes.

Try to improve grammar and use versionadded

Gave _ellipsis_match() an attractive new leading underscore.

Fix markup.  versionchanged automatically adds a period, so remove the extra one.

Establish policies with respect to 2.3 compatibilty and treated spec
updates as bugfixes.

SF bug #1012315:  weakref.WeakValueDictionary should override .has_key()

* Check the found object for a None value during a contains/has_key
  lookup.  Perhaps it will help the OP who is likely suffering from an
  occassional GC or threading object deletion after self.data is checked.

* Complete the previous patch by removing the unnecessary indirection
  for weak dict iterators.  Makes the code cleaner and more readable.

Got rid of nooutput() (was used by DocTestCase.debug())

It's redundant, since no output is written anyway: DebugRunner doesn't
generate any output for failures and unexpected exceptions, and since
verbose=False, it won't generate any output for non-failures either.

Updated __all__ to include every non-underscored class, function, and
constant defined by the module (except the test*() functions, which
should be integrated into test/test_doctest.py, anyway).

Bug #1005737, #1007249: Fix several build problems and warnings
found on old/legacy C compilers of HP-UX, IRIX and Tru64.  (Reported
by roadkill, Richard Townsend, Maik Hertha and Minsik Kim)

Bug #1005737, #1007249: Fix several build problems and warnings
found on legacy C compilers of HP-UX, IRIX and Tru64.  (Reported
by roadkill, Richard Townsend, Maik Hertha and Minsik Kim)

Now that they've settled down, document doctest directives.

Port test_zipfile to unittest (patch #736962).

ellipsis_match():  Changed treatment of start- and end-of-string exact
matches to be symmetric.  This makes the algorithm easier to understand.

Patch #900727: Add Py_InitializeEx to allow embedding without signals.

Patch #1011822: Display errno/strerror for inaccessible files.

Replaced the ELLIPSIS implementation with a worst-case linear-time one.

ELLIPSIS implementation:  an ellipsis couldn't match nothing if it
appeared at the end of a line.  Repaired that.  Also noted that it's
too easy to provoke this implementation into requiring exponential
time, and especially when a test fails.  I'll replace the implementation
with an always-efficient one later.

Rewrite test_order so as to be more "proper".  Originally relied on an
error based on decorating with staticmethod too soon for the code to execute.
This meant that if the test didn't pass it just errored out.  Now if the test
doesn't pass it leads to a failure instead.

fix SF bug #1008690: Incorrect <link rel="index"> href in Tutorial

The make_head_and_body() function used a hardcoded value for the
<link> element for the index; this patch causes the proper output
filename to be captured during the transformation phase so it can be
used during the page assembly phase.

Remove commented definition of the MKHOWTO macro.

Remove zero-byte gif files from generated html docs

Expand tabs.

Add support for FreeBSD 6.

Patch #995126: Correct directory size, and generate GNU tarfiles by default.

Patch #914291: Restore locale while readline is running.

Patch #1011144: Correct regex for coding decls.

Patch #980082: Missing INCREF in PyType_Ready.

Patch #800236: add HTTPResponse.getheaders().

Patch #1006219: let inspect.getsource show '@' decorators and add tests for
this (which are rather ugly, but it'll have to do until test_inspect gets a
major overhaul and a conversion to unittest). Thanks Simon Percivall!

Patch #791776: Replace SMTPHandler.date_time with email.Utils.formatdate.

Patch #764217: Add nametofont function, exists parameter.

Move the bytecode optimizer upstream so that its results are saved in pyc
files and not re-optimized upon import.  Saves a bit of startup time while
still remaining decoupled from the rest of the compiler.

As a side benefit, handcoded bytecode is not run through the optimizer
when new code objects are created.  Hopefully, a handcoder has already
created exactly what they want to have run.

(Idea suggested by Armin Rigo and Michael Hudson.  Initially avoided
 because of worries about compiler coupling; however, only the nexus
 point needed to be moved so there won't be a conflict when the AST
 branch is loaded.)

Various alpha 3 updates.

Deprecate sys.exitfunc in favor of the atexit module.
Per Guido, sys.exitfunc will be kept around for backwards compatability
but atexit will become the one preferred way to do it.

This is Mark Russell's patch:

[ 1009560 ] Fix @decorator evaluation order

From the description:

Changes in this patch:

- Change Grammar/Grammar to require
newlines between adjacent decorators.

- Fix order of evaluation of decorators
in the C (compile.c) and python
(Lib/compiler/pycodegen.py) compilers

- Add better order of evaluation check
to test_decorators.py (test_eval_order)

- Update the decorator documentation in
the reference manual (improve description
of evaluation order and update syntax
description)

and the comment:

Used Brett's evaluation order (see
http://mail.python.org/pipermail/python-dev/2004-August/047835.html)

(I'm checking this in for Anthony who was having problems getting SF to
talk to him)

Fixed bug in line-number finding for examples (DocTestParser wasn't
updating line numbers correctly for bare prompts & examples containing
only comments).

There are no longer any special case test skips.

Remove test of obsolete trim() operation which was supplanted by
normalize() in Draft 1.06 (9 October 2002):

  The normalize operation has been added; it reduces a number to a
  canonical form.  (This replaces the trim operator, which only
  removed trailing fractional zeros.)

Use readline/raw_input() in pydoc.Helper.interact if available and self.input
is sys.stdin. Based on a patch (#726204) by Dmitry Vasiliev and a comment from
Guido in an older patch (#549901).

The get_installer_filename() method forgot to return the name it
calculates.  Spotted by Cort Danger Stratton.

SF bug #833957:  Ctrl+key combos stop working in IDLE

Make key combinations work with upper and lowercase as is the MS standard.