bring structure closer to std config.c, whitespace normalisation

fix a merge mistake - readline not built by default

- documented Ellipsis, NotImplemented
- minor markup changes
- indented for consistency with newer content

Add dependency info for the recently added lib/libconsts.tex.

Document that apply() is deprecated.  See:
http://mail.python.org/pipermail/python-dev/2003-January/031556.html

Completed astimezone's correctness proof.  That doesn't mean it's
correct by your lights, it means that-- barring coding errors --it
implements what it intended to implement.

Clearing out old patch queue. Patch #558547, make SocketServer more
robust. This makes socketserver's close() method callable repeatedly
without error - similar to other file-like objects.

Add byext.py

A quicker astimezone() implementation, rehabilitating an earlier
suggestion from Guido, along with a formal correctness proof of the
trickiest bit.  The intricacy of the proof reveals how delicate this
is, but also how robust the conclusion:  correctness doesn't rely on
dst() returning +- one hour (not all real time zones do!), it only
relies on:

1. That dst() returns a (any) non-zero value if and only if daylight
   time is in effect.

and

2. That the tzinfo subclass implements a consistent notion of time zone.

The meaning of "consistent" was a hidden assumption, which is now an
explicit requirement in the docs.  Alas, it's an unverifiable (by the
datetime implementation) requirement, but so it goes.

mention built-in constants.

process libconsts.tex

new section - builtin constants

add find-uname.py

Search for Unicode character names using regular expressions.

Split OPT make variable into OPT and BASECFLAGS.  The latter contains those
compiler flags which are necessary to get a clean compile.  The former is
for user-specified optimizer, debug, trace fiddling.  See patch 640843.

Add /sw/lib and /sw/include to setup.py search paths on Darwin to take
advantage of fink goodies.

Add scriptsinstall target to Makefile to install certain scripts from
Tools/scripts directory.

Move _PyInt_Init() into pythonrun.h, since all the other _Init()
functions are here.  Suggested by Skip.

Revert last change -- test works on HPUX again after Martin's checkin
to 'properly configure the slave terminal'

See SF patch # 656590 for the details.

Silly little script to print statistics (files, lines, words) by
extension.  Could use some work, but already very useful.

Expose I_ constants. Auto-detect stropts.h. Properly configure the slave terminal.

Revert merge from 2.3 alpha 1 release branch; the change does not
apply to the trunk.

datetimetz_astimezone():  Speed optimizations -- although I'd rather
find a more elegant algorithm (OTOH, the hairy new implementation allows
user-written tzinfo classes to be elegant, so it's a big win even if
astimezone() remains hairy).

Darn!  I've only got 10 minutes left to get falling-down drunk!  I suppose
I'll have to smoke crack instead now.

The failure of the last-second addition to the timezone coversion test is
understood now:  it can't work.  Added comments explaining why (it's "the
usual"-- unrepresentable hours in local time --but in a slightly different
guise).

Merging in changes from r23a1-branch.  Doc/makefile had conflicts, which
I leave to Fred to sort out.

More installation info.  Bump alpha version.

Debugger was tracing through rpc.py when IDLEfork was not started
from its source directory.  Generalize the "workaround" (though
the latter seems a reasonable solution?) to handle this.

Improve exception handling.

Try to get compilation working for cygwin

Patch #660485: Cygwin _tkinter Tcl/Tk 8.3 patch

The attached patch enables Cygwin Python to
build cleanly against the latest Cygwin Tcl/Tk
which is based on Tcl/Tk 8.3. It also prevents
building against the real X headers, if installed.

The trunk is (nominally) post-alpha.

Merge to trunk from release branch:

Plug the leak that Tim just reported.

Make two tests non-locale-dependent

Results of a rewrite pass

- use classdesc where we can (for better indexing)
- more style consistency crud

Replace all but one explicit emit('SET_LINENO') with call to set_lineno().

Remove broken code in visitDict().  I assume the code was trying to
add set lineno events for each line of a dict constructor, but I think
it was using the wrong object (node instead of k or v).

Don't let the docstring end up in __main__.__doc__

test01_close_dbenv_before_db(): Added an XXX comment that this test is
BerkeleyDB version dependent.

Comment out test, since it hangs on HPUX, still investigating

SF patch [ 597919 ] compiler package and SET_LINENO

A variety of changes from Michael Hudson to get the compiler working
with 2.3.  The primary change is the handling of SET_LINENO:

# The set_lineno() function and the explicit emit() calls for
# SET_LINENO below are only used to generate the line number table.
# As of Python 2.3, the interpreter does not have a SET_LINENO
# instruction.  pyassem treats SET_LINENO opcodes as a special case.

A few other small changes:
 - Remove unused code from pycodegen and pyassem.
 - Fix error handling in parsermodule.  When PyParser_SimplerParseString()
   fails, it sets an exception with detailed info.  The parsermodule
   was clobbering that exception and replacing it was a generic
   "could not parse string" exception.  Keep the original exception.

General style conformance.  Markup some unmarked constructs.

Update (slightly) for Alpha release

Remove bogus test; the master is not a terminal on Solaris and HP-UX.

Move history to HISTORY.txt

Update for Alpha 0 Release

Add recipe for creating NEWS.html.

A new, and much hairier, implementation of astimezone(), building on
an idea from Guido.  This restores that the datetime implementation
never passes a datetime d to a tzinfo method unless d.tzinfo is the
tzinfo instance whose method is being called.  That in turn allows
enormous simplifications in user-written tzinfo classes (see the Python
sandbox US.py and EU.py for fully fleshed-out examples).

d.astimezone(tz) also raises ValueError now if d lands in the one hour
of the year that can't be expressed in tz (this can happen iff tz models
both standard and daylight time).  That it used to return a nonsense
result always ate at me, and it turned out that it seemed impossible to
force a consistent nonsense result under the new implementation (which
doesn't know anything about how tzinfo classes implement their methods --
it can only infer properties indirectly).  Guido doesn't like this --
expect it to change.

New tests of conversion between adjacent DST-aware timezones don't pass
yet, and are commented out.

Running the datetime tests in a loop under a debug build leaks 9
references per test run, but I don't believe the datetime code is the
cause (it didn't leak the last time I changed the C code, and the leak
is the same if I disable all the tests that invoke the only function
that changed here).  I'll pursue that next.

Eliminate C++ comment.

Use funcdesc instead of classdesc to be consistent with out sections.

Further cleanup of exceptions.  All interpolation-related exceptions
now derive from InterpolationError, which is not raised directly (only
subclasses get raised).  This matches what the docs already said.

Bernhard Herzog's paragraph and string-filling code.  I've been using it for
a month or two with great success.  Barry may want to tweak it some, but I
think it's a worthwhile enough addition to get some more people trying it
out.

Keep __main__ namespace clean

modulefinder.py moved to Lib/

Spelling fix

Fix an out-of-bound index in pmerge() discovered by Zooko (SF bug
645404).  I'm not 100% sure this is the right fix, so I'll keep the
bug report open for Samuele, but this fixes the index error and passes
the test suite (and I can't see why it *shouldn't* be the right fix
:-).

patch attached to sf item #643711:
any_missing() returns less bogus missing modules.

- I've rewritten scan_code() more or less from scratch,
factored bits and pieces out for readability.
- keep track of global assignments and failed imports per
module; use this to determine whether the Y in "from X
import Y" is a submodule or just a global name. This is not
100% doable: you can't tell which symbols are imported when
doing a star import of a non-Python module short of actually
importing it.
- added a new method to ModuleFinder: any_missing_maybe(),
which returns *two* lists, one with certain misses, one with
possible misses. The possible misses are *very* often false
alarms, so it's useful to keep this list separate.
any_misses() now simply returns the union of
any_missing_maybe().

TODO: documentation, test_modulefinder.py

Add markup for time object.
Cleanup whitespace.
Fix unbalanced parenthesis.

moving modulefinder.py to the standard library

Fix compilation errors on HPUX11

Whitespace Normalization

Removed the now-untrue (or soon-to-be untrue) part of the astimezone()
docs.  Replaced it with an XXX block, because the hoped-for treatment
of DST endcases remains unclear (Guido doesn't really like raising an
exception when it's impossible to deliver a correct result, but so
far I have no way in hand to consistently deliver a defined incorrect
result either).

removed unused get_short() function

Set the release date.

Document the new ,netrc awareness in nntplib.

Barry raised reasonable objections to the macro name \mimeheader, so
we'll simply revert to \mailheader since there's no other good name.

- correct the deprecation markups so this formats again
- some minor cleanups

Restore signalhandler in case of error. Fix type of signal handler.

Complete the markup for timedelta objects.
Fix a curly brace that should have been a paren.

Add posix.loadavg()
Add some times

Revert SF patch 659809 -- it causes double options that can cause breakage.

Use the name (path) specified in the parameter list

Add getloadavg.

Patch #658927: Add getctime to os.path.
Document that getatime and getmtime may return floats.

Patch #656590: /dev/ptmx support for ptys.

Make sure zip_path is null-terminated, since it's on the stack

Document standard encodings.

Make sure zip_path is null-terminated, since it's on the stack

SmartCookie and SerialCookie were recently deprecated

InterpolationSyntaxError was added in 2.3

OS/2 EMX has no popen2.Popen3 even though bunzip2 is available

add list of expected skips for the OS/2 EMX port

DLL export definition refresh

add universal newline support to configuration

whitespace cleanup

getenv() replacement not required

Build process updates:
 - add new modules (zipimport, datetime, _random, bz2, _symtable)
 - build pyexpat with expat sources from Python distribution
 - regression test with and without compiled bytecode

Broke the zipimport/PEP 302 news item into two separate items.

- added missing decref
- whitespace normalization

Make sure PrettyPrinter methods that mirror the module-level
convenience functions isreadable() and isrecursive() work the same way
as the convenience functions.

- PrettyPrinter.isreadable(), .isrecursive():
    Pass the right number of args to .format().  (Caught by
    pychecker.)
- Protect the global namespace more carefully.
- Don't use the types module now that we don't need to.

Add a test that InterpolationError is constructed properly and raised
when expected.  Only applies to the ConfigParser and SafeConfigParser
classes, not RawConfigParser.

ConfigParser._interpolate():  Pass the missing key to the
    InterpolationError constructor, not the KeyError exception itself.
    (Caught by the new InterpolationError test.)

SafeConfigParser._interpolate_some():  Pass the right number of
    arguments to the InterpolationError constructor.
    (Caught by pychecker.)

Update version numbers.

Phrase repair.

Minor markup and spelling repair.

Since the *_Init() are private, prefix with _, suggested by Skip

Add build_namelists() to expose the OSS macros SOUND_DEVICE_LABELS and
SOUND_DEVICE_NAMES as 'control_labels' and 'control_names'.

Rename the parameter 'xp' in several methods to 'self', since that's
what it is.

For symmetry with the mixer interface, rename oss_t to oss_audio_t and
OSSType to OSSAudioType.

Add a bunch of comments to clearly delineate sections of the code.

Yet another renaming of some mixer methods:
  devices(), stereodevices(), recdevices() ->
  controls(), stereocontrols(), reccontrols()

Based on recommendation of Hannu Savolainen <hannu@opensound.com>:

  The right term to use for things like bass/treble/mic/vol/etc is
  "control".

  "Device" refers to different mixer devices (/dev/mixer0 to /dev/mixerN).

  "Channel" cannot be used because it refers to mono/stereo/multich
  channels. In fact most mixer controls have left/right channels so ...

Add a hurriedly-written section on the datetime module