Remove the random=None nonsense from sample() before it gets set in stone.
It was once available so that faster generators could be substituted.  Now,
that is less necessary and preferrably done via subclassing.

Also, clarified and shortened the comments for sample().

Moved this info to the top-level README where all the other
platform-specific verbiage lives.

The bsddb3 library does not build w/ Berkeley DB 3.0.  3.1 is the earliest
supported version.

Merged Misc/AtheOS-NOTES into the platform-specific section.  Rewrote the
bsddb module build note to reflect the inclusion of bsddb3 and the demotion
of the old bsddb module.

SF bug #655271: Slightly modify locals() doc

Clarify the operation of locals().

SF bug #651149: Review libshelve.tex when possible

Minor fixes to markup, spelling, parameter names, and abbreviations.

M AutoExpand.py
M Bindings.py
M EditorWindow.py
M PyShell.py
M config-keys.def
M configHandler.py
M help.txt

1. Annotate the shell window with last restart boundary upon restart.
2. Provide a shell menu entry and hot key (F6) to jump to the last
   restart boundary.
3. Add a new shell menu feature to restart the shell.
4. Update the help menu to add these features.
5. Update the help menu to put text in same order as the menus.
6. Correct a capitalization inconsistency on the Edit menu: Expand Word
7. Rename the "Debug" menu to be "Shell": it's doing more now.
8. Rearrange the "Shell" menu to make the StackViewer entries adjacent.
9. Add a get_geometry method to EditorWindow, which may be of use in
   making window positions persisent.
10. Make <ctrl-v> the "Classic Windows" paste key.
11. Restore decorum on the Help menu by removing "Advice".  As Guido said,
    things will never be the same.  Thanks, David!

Fix compiler warning

SF Patch #661440: Refactor and streamline PyCFunction_Call

Refactor code in PyCFunction_Call giving a modest (tiny) speed boost,
a slight improvement in semantics (now detects invalid flag combinations),
and (arguably) improved clarity (making it blindingly clear which flag
combinations are allowed).  All this comes at a cost of a few lines of
code duplication.

* Folded test for METH_KEYWORDS into the switch/case.
* Deferred testing for an empty dictionary until when and where needed.
* Make a similar deferral for filling the "size" variable.
* Inverted the dictionary test so that the common case falls though
  instead of making a jump.

Wrap doc strings in PyDoc_STRVAR. Fix .string docstring. Provide default
macro definitions for older Python releases.

Completed astimezone()'s correctness proof.  This also proves we can get
the desired compromise behavior during the "problem hour" when DST ends
cheaply (but I haven't yet implemented that).

Convert Tcl path objects to strings. Fixes #661357.
Provide .string attribute and __unicode for Tcl_Objs.

Remark about datetime tzinfo examples.

Replaced the flawed "local time" example tzinfo class with the guts
of Guido's later Local.py (from the datetime sandbox).

Grammatical fix in comment.

Grammatical fix: change possessive "it's" to "its".

Remove a list comprehension, because a loop over the list
is done afterwards anyway, so what the list comp does
can be done in the loop.

Pass the strict argument from read() on to readfp(), so the
file content ends up in the correct dict.

Use RUNSHARED for python invocations. Fixes #661408.

Fix read_mime_types() so that it returns a dict as documented.
This fixes a bug reported as http://www.python.org/sf/661630,
which was introduced in the patch http://www.python.org/sf/554192.

Allow PyFile_GetLine() to return Unicode objects. Fixes #660165.

Fix SF #659228, 'realpath' function missing from os.path

Also added realpath = abspath for os2emx, similar to windows/mac
which also don't really implement realpath.

Backport candidate, I think?

Spread the blame (err, I mean credit) for ossaudiodev around a bit.

Mention ossaudiodev.

Fix SF #659228, 'realpath' function missing from os.path

Also added realpath = abspath for os2emx, similar to windows/mac
which also don't really implement realpath.

Backport candidate, I think?

Write PEP 301 section
Mention difference between 2.2.2 and 2.3 True and False

Mention that imaplib now supports SSL -- this wasn't noted before.

qualify known Solaris versions related to the binutils breakage.

Add SSL support for imaplib; add empty PEP301 section

update info about binutils 2.13 breakage on Solaris.

[Patch #658093 ] Documentation support for PEP 301
  Add two sections to this manual about package meta-data and about
  registering packages

[Patch #658094 ] PEP 301 implementation
   Add the 'register' distutils command

[Patch #658094] PEP 301 implementation
  Add 'classifiers' keyword to DistributionMetadata

Fix for bug #661136
Lesson learned: kids should not be allowed to use API's starting
with an underscore :-/
zipimport in 2.3a1 is even more broken than I thought: I attemped
to _PyString_Resize a string created by PyString_FromStringAndSize,
which fails for strings with length 0 or 1 since the latter returns
an interned string in those cases. This would cause a SystemError
with empty source files (and no matching pyc) in the zip archive.
I rewrote the offending code to simply allocate a new buffer and
avoid _PyString_Resize altogether.
Added a test that would've caught the problem.

Add contributor.

Remove debugging prints.

SF patch 660559: Use METH_O and METH_NOARGS where possible

Simplify code and speed access by using PyArg_UnpackTuple, METH_O and
METH_NOARGS in three modules that can benefit from it.

Fixed markup.

Updated (2.3 OK now)

Fix error in previous correction; thanks, Just!

Jack complained that on test_crlf_separation() was failing on MacOS9
because the test file, msg_26.txt which has \r\n line endings, was
getting munged by cvs, which knows to do line ending conversions for
text files.  But we want \r\n to be preserved on all platforms, so we
cvs admin'd the file to be -kb (binary), which means we have to open
the file in binary mode to preserve these line ends.  Hopefully this
will be the end of the thrashing on this issue (but probably not).

Test passes on *nix now, and Tim confirms it passes on Windows.  We'll
leave it to Jack to test MacOS.

Fix PEP 302 description; bump version number

The tzinfo methods utcoffset() and dst() must return a timedelta object
(or None) now.  In 2.3a1 they could also return an int or long, but that
was an unhelpfully redundant leftover from an earlier version wherein
they couldn't return a timedelta.  TOOWTDI.

Allow list sort's comparison function to explicitly be None.  See SF patch
661092.

1. Remove obsolete, incorrect comment on non-package installation
2. Add more .txt files to installation
3. Fix the reference to Visual Python, s/b VPython

astimezone() internals:  if utcoffset() returns a duration, complain if
dst() returns None (instead of treating that as 0).

Added a section to record datetime changes.  There's apparently going to
be an unbounded number of API changes <0.6 wink>.

The astimezone() correctness proof endured much pain to prove what
turned out to be 3 special cases of a single more-general result.
Proving the latter instead is a real simplification.

Improve exception handling.

There are two more copyright notices in the Windows world:

PC/python_nt.rc sets up the DLL version resource (displayed when you
right-click on the DLL and select Properties).

PCbuld/python20.wse sets up the installer version resource (displayed
when you right-click on the installer .exe and select Properties).  Turns
out this one hadn't been updated since 2001 <frown>!

SF bug 661086: datetime.today() truncates microseconds.
On Windows, it was very common to get microsecond values (out of
.today() and .now()) of the form 480999, i.e. with three trailing
nines.  The platform precision is .001 seconds, and fp rounding
errors account for the rest.  Under the covers, that 480999 started
life as the fractional part of a timestamp, like .4809999978.
Rounding that times 1e6 cures the irritation.

Confession:  the platform precision isn't really .001 seconds.  It's
usually worse.  What actually happens is that MS rounds a cruder value
to a multiple of .001, and that suffers its own rounding errors.

A tiny bit of refactoring added a new internal utility to round
doubles.

Update the copyright year.

Another copyright update.  (JvR: can you backport this to the 2.3a1
release branch?)

SF bug 660795:  logging missing from Python 2.3a1 for Windows.
Added the logging package.  In the meantime, Neal Norwitz added a
test_logging.py to the std test suite, which would have caught this
oversight in the Windows installer.

Add some version info for new methods and class

SF #660795

Add a test for logging from Vinay Sajip (module author)

Fix an example

Replaced imp.set_frozenmodules() cruft with proper zipimport support.
This work uncovered the zipimport bug in 2.3a1 -- wish I'd had time to
do this before the release :-(.

Ugh, zipimport is virtually broken in 2.3a1 :-( It worked by accident in
the test set as it only tested with a zip archive in the current directory,
but it doesn't work at all for packages when the zip archive was specified
as an absolute path. It's a real embarrassing bug: a strchr call should
have been strrchr; fever apparently implies dyslexia.

Second stupid bug: the zipimport test failed with a name error
__importer__ (which I had renamed to __loader__ everywhere but here).
I would've sworn I ran the test after that change but that can't be true.
What I don't understand that noone reported a failing test_zipimport.py
before the release of 2.3a1.

EMX fork() emulation not good enough to cope with test_socketserver

OS/2 sockets do not support AF_UNIX, even though EMX headers define it

catch up with zipimport changes to std getpathp.c

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.