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.

This file is no longer used in version 2.39.
Was supplanted by tointegral.decTest.

Add two new files and update remaining tests from the latest update of the
test suite in version 2.39 of dectest.zip.

Revise max() and min() to comply with the 8/2/2004 update to the specification
(version 1.45):

The max and min operations follow the rules in the current IEEE 754 revision draft:
if one operand is a quiet NaN and the other is number, then the number is always returned
if both operands are finite and equal in numerical value then an ordering is applied:
    if the signs differ then max returns the operand with the positive sign and
    min returns the operand with the negative sign; if the signs are the same then
    the exponent is used to select the result.

* Dynamically build a list of files to be tested (necessary because
  version 2.39 of dectest.zip adds some new test files and because
  some existing test files were getting skipped).
* Remove two docstrings which cluttered unittest's output.
* Simplify a for-loop with a list comprehension.

SF bug #951482:  New module: doc versus action

Strengthen the warnings about creating bogus objects using the new module.

SF bug #805304:  super instances don't support item assignment

Document a nuance of super().  It is designed to work well with dotted
attribute lookup but not with equivalent implicit lookups using operators
or statements.

fix a couple problems with the last patch picked up by Michael Hudson

Typo fix

Test cases and fixes for bugs described in patch #873418: email/Message.py:
del_param fails when specifying a header.

Being bsd-based, darwin/macosx has the same limitation w.r.t. the "echo"
service.

- pygettext.py: Generate POT-Creation-Date header in ISO format.

The attached patch fixes FTBFS on GNU/k*BSD.  The problem happens on GNU/k*BSD
because GNU/k*BSD uses gnu pth to provide pthreads, but will also happen on any
system that does the same.

python fails to build because it doesn't detect gnu pth in pthread
emulation. See C comments in patch for details.

patch taken from http://bugs.debian.org/264315

Minor improvements to the threading introduction:

* Expand the example to show a join.

* Mention the use case of I/O running concurrent with a computational
  thread.

* Be a tad more forceful about recommending Queue over other approaches
  to synchonization.

* Eliminate discussion around having a single interpreter.  This is a
  more advanced discussion that belongs in the library reference and
  in a section on extending and embedding.

Minor formatting cleanup.

* Uncomment the SyntaxError doctest after Tim demonstrated how.
* Remove unnecessary sys.PS2 prompt lines.

Fix punctuation typo.

Add a notes section to the docs:

* Discuss representation error versus loss of significance.
* Document special values including qNaN, sNaN, +0, -0.
* Show the suprising display of non-normalized zero values.

SF patch #872326:  generator expression implementation
(Contributed by Jiwon Seo.)

Add genexps to the reference manual.

- Bug #891637, patch #1005466: fix inspect.getargs() crash on def foo((bar)).

Add get_history_item and replace_history_item functions to the readline
module.  Closes patch #675551.  My apologies to Michal Vitecek for taking so
long to process this.

Match the def'n of _XOPEN_SOURCE on Solaris 8/9 to suppress redefinition
warning from GCC.  Closes patch #1006629.

Quote \r\n correctly, remove random indentation (patch #1009384). Thanks
Cherniavsky Beni!

Correct the order of application for decorators.  Meant to be bottom-up and not
top-down.  Now matches the PEP.

Fix incorrect comment for (struct compiling)->c_cellvars

Let cgi.parse_header() properly unquote headers (patch #1008597).

bug #989672: pdb.doc and the help messages for the help_d and help_u methods
of the pdb.Pdb class gives have been corrected. d(own) goes to a newer frame,
u(p) to an older frame, not the other way around.

bug #990669: os.path.realpath() will resolve symlinks before normalizing the
path, as normalizing the path may alter the meaning of the path if it contains
symlinks.

Also add tests for infinite symlink loops and parent symlinks that need to be
resolved.

Catch OSError raised when src or dst argument to os.path.samefile doesn't
exist.

bug 990669: os.path.normpath may alter the meaning of a path if it contains
symbolic links. This has been documented in a comment since 1992, but is now in
the library reference as well.

bug #851123: shutil.copyfile will raise an exception when trying to copy a file
onto a link to itself. Thanks Gregory Ball.

Unwrap too-smart loop: we can't use `src` for both hard and symbolic links.