Avoid the use of 'unset', which isn't available on all platforms. Fixes SF
bug #442627.

minor tidy-ups ready for 0.8.1 alpha tarball release

Remove some false statements.

Remove some false comments.

Reorganize so the initialization sequences does not bite us in the foot.
(There is no good reason to discard classes that clients may want to
subclass.)

Fill out the Unicode section, somewhat uncertainly

Finish the "Other changes" section
Bump version number
Insert a few blank lines here and there

Fix a few typos

Remove note about this being a draft document.
Note the actual date of 2.1's release

Look to the future: bump the version number.

Do more to ensure we don't do any more formatting than we need to.
Use separate targets for the distribution packages for paper-based and
non-paper-based formats; this avoids some extra packaging when a complete
distribution is being built with both paper sizes.

2.2a1 is out; look to the future.

Ignore all .tar files in the top directory; we're about to generate
more of them.

SF bug #442520: test_struct fails on SPARC.
The ob_sval member of a string object isn't necessarily aligned to better
than a native long, so the new "q" and "Q" struct codes can't get away w/
casting tricks on platforms where LONG_LONG requires stricter-than-long
alignment.  After I thought of a few elaborate workarounds, Guido bashed
me over the head with the obvious memcpy approach, herewith implemented.

If the user's environment has set the BROWSER environment variable (as Gnome
seems to do), the user may not be aware of its contents.  Attempt to add any
to _browsers.

closes bug #429136

Lots of small updates, some long overdue.

Add a more substantial example startup file for the interactive shell;
sample startup script provided by Itamar Shtull-Trauring.

This closes SF patch #410890.

Add some logical markup where it was missing.

Minor changes for stylistic cleanliness and consistency.

Change the command lines to use a similar "phrasing" to that used in the
other documentation makefiles.  This is probably not sufficient to run
the conversion on Windows, but goes at least part way.

"Make small changes, but carry a big diff."

Minor local consistency adjustments.
A couple of small tweaks to the setdlopenflags() description.
For setprofile() and settrace(), convert some references to become
hyperlinks in the HTML version.

Add some symbolic names to support hyperlinked references.

Add "help" to the things one is encouraged to type for more
information.  (I found this idea in the ActivePython 2.1 diffs.)

Made a few minor style & markup changes to the new {get,set}dlopenflags()
descriptions; added availability notes.

Deactivate definition of ss_family and ss_len. Fixes bug #440486.

Patch #412229: Add functions sys.getdlopenflags and sys.setdlopenflags.
Add dlopenflags to PyInterpreterState, and use it in dlopen calls.

Patch #432117: Record namespaces in the DOM tree using the DOM xmlns prefix.

Ignore the html-*.tar file that can now be generated as an intermediate.

Revise the rules for building the distribution files for the HTML format.
These work again.

Mirror Guido's latest changes to the license file.

Be more specific about some of the dependencies, to avoid re-building when
some of the mostly-general files get changed.

Define new markup for 5-column tables.

Remove a couple of lines from the test that proved not to be portable to
all platforms that offer tempnam().

Kill another merge zombie.

Kill another merge zombie.

Kill a merge zombie.

Start of a test suite for the "os" module -- this only tests the temporary
file management functions that have just been made available on more
platforms.

Used an adapted MethodGenerator to generate methods too for functions that have the object as the second arg after a first CFAllocatorRef arg (which we pass as NULL always anyway).

Oops, left in a debug statement. It's gone now.

Update the availability information for os.tempnam(), os.tmpfile(), and
os.tmpnam().

On Windows, tempnam() is spelled with a leading underscore.

Define the constants needed to allow the os.tempnam(), os.tmpfile(), and
os.tmpnam() functions to be made available.

This is part of SF patch #435492.

A new attempt at rationalizing the "history of the software" section,
with a table clarifying which releases are GPL-compatible.

Also unified the headings for the various licenses.

Adding what's done of the documentation for the new profiling &
tracing interface.  Incomplete, but better to check it in since I've
been including it in my updates.

Use the "st" versions of the "ast" calls in the parser module -- there is
no reason to pretend the syntax trees we're dealing with are abstract.

The syntax trees handled by this module are not "abstract," so take the
"A" out of the internal abbreviations.  For published functions with
"ast" in their names, make alternate offerings using just "st".

Typo repair.

Remove code to initialize globals that are never used.
Add some casts to quiet warnings from an unspecified non-GCC compiler.

This closes SF patch #436258.

Delete sentence fragment (noted by Fred Bremmer)

- Add news about generators.
- Change header to 2.2a1.
- Add separator between 2.2 and 2.1 news.

Bump the release number.

Make the syntax of compound command lines more portable (nmake, CygWin).
These changes are an adaptation of SF patch #429611.

Use the new tools/rewrite.py instead of grep/date/sed to transform
html/index.html.in into html/index.html; this is required for portability.

Add a really stupid warning about 'yield' used as an identifier.

This is really stupid because it cannot be suppressed or altered using
the warning framework; that's because the warning framework is built
on Python interpreter internals, and the parser generator doesn't have
access to any of those (you cannot use anything of type PyObject * in
the parser).

But it's better than nothing, and implementing a proper check for this
appears to require modifying compile.c in a dozen places, for which I
don't have the stamina today.  I promise we'll do better in 2.2a2.

At least it tells you the filename and line number (unlike the first
hack I considered :-).

Make the syntax for compound command lines more portable (nmake, CygWin).
This is probably not sufficient by itself for the info generation, and is
being done mostly to keep the style consistent with additional patches
that will be applied to Doc/Makefile.

Script to re-write @FOO@-style marks with values, initializing the
replacement for @DATE@ from a TeX file containing a \date{...} mark
(such as texinputs/boilerplate.tex).

This will be used to re-write the html/index.html.in file instead of
a combination of grep, date, and sed -- this is more portable to non-Unix
platforms.

This solves part of the problem reported in SF patch #429611, but does
not use the suggested patch.

Update the release information.

Deleting zombies

Now we're picking nits:  get my name right!  ;-)

Add FLD to credit list
Correct grammatical error

Job.__init__():  Only create the builddir directory if it will be used (by
    building the HTML or text documentation).  There is no need to create
    it for other formats.

Job.build_html():  The builddir parameter is always passed in, so it need
    not be optional.

Deleting merge zombie.

Cleaned up a number of minor nits, use markup a little more consistently.

Minor rewrites to iterator and generator sections
Credit both Neil and Tim for generators
Fix indentation of a few paragraphs

Fix a couple of minor markup nits.
Footnotes should be added *after* punctuation, not before.
(Yes, this should be merged with the descr branch.  Sorry, Tim!)

INSTALLATION: Remove the coexist.patch instructions

****************
setup.py:

Remove the idles script, add some words on IDLE Fork to the
long_description, and clean up some line spacing.

Put this in the attic, at least for now...

Implement idle command interface as suggested by GvR [idle-dev] 16 July
****************
PyShell: Added functionality:

usage: idle.py [-c command] [-d] [-i] [-r script] [-s] [-t title] [arg] ...

idle file(s)    (without options) edit the file(s)

-c cmd     run the command in a shell
-d         enable the debugger
-i         open an interactive shell
-i file(s) open a shell and also an editor window for each file
-r script  run a file as a script in a shell
-s         run $IDLESTARTUP or $PYTHONSTARTUP before anything else
-t title   set title of shell window

Remaining arguments are applied to the command (-c) or script (-r).

******************
idles: Removed the idles script, not needed

******************
idle:  Removed the IdleConf references, not required anymore

Prepare Windows installer for 2.2a1.

Added tests for the new yield support in the parser module.
(Should be merged with descr branch.)

Add support for yield statements.
(Should be merged with descr branch.)

Typo in the classic mlte build line.

The TNXDraw gworld argument is optional.

It now works under Carbon. Under Classic the scrollbars don't show
up, for reasons unknown.

This has never worked on Windows.  Now it does.  If it breaks on Unix now,
great, it's your turn to watch it fail for months <0.9 wink>.

Updated the documentation in several respects:

- This module, despite its name, now should conform to RFC 2822, the
  update to RFC 822.

- This module doesn't just represent "email headers", but entire email
  messages.

- Added documentation for other useful public functions such as
  quote(), unquote(), praseaddr(), and dump_address_pair().

test_basic(): Add a test for "person@dom.ain (User J. Person)" which
was already correctly parsed (contrary to a comment in Mailman).

test_rfc2822_phrases(): RFC 2822 now requires that we allow `.' in
phrases, which means we must accept dots in unquoted realname parts.
Add a test to check the change in rfc822.py 1.58.

Stoopid change, just to mention that the last checkin resolves SF bug
#437395

Fix address parsing to be RFC 2822 conformant.  Specifically, dots are
now allowed in unquoted RealName areas (technically, they are defined
as "obsolete syntax" we MUST accept in phrases, as part of the
obs-phrase production).  Thus, parsing

    To: User J. Person <person@dom.ain>

correctly returns "User J. Person" as the RealName.

AddrlistClass.__init__(): Add definition of self.phraseends which is
just self.atomends with `.' removed.

getatom(): Add an optional argument `atomends' which, if None (the
default) means use self.atomends.

getphraselist(): Pass self.phraseends to getatom() and break out of
the loop only when the current character is in phraseends instead of
atomends.  This allows dots to continue to serve as atom delimiters in
all contexts except phrases.

Also, loads of docstring updates to document RFC 2822 conformance
(sorry, this should have been two separate patches).

File handlers don't work on the mac, so don't pretend they do. I guess this is a 2.1.1 candidate, if it isn't too late for that.

Add a unit test for sgmllib (needs work, but has already caught problems).
Based on the test for the HTMLParser module.

Give more useful information about a failing PyUnit-style test.

Remove a duplicate test.

Document doctest's generator-future hack.

In CDATA mode, make sure entity-reference syntax is not interpreted;
entity references are not allowed in that mode.

Do a better job of scanning <!DOCTYPE ...> declarations; based on the
code in HTMLParser.py.

jcompile(): inherit the CO_GENERATOR_ALLOWED flag from the 'base'
compiling struct.

PyRun_StringFlags(): forgot to pass the flags on to
PyParser_SimpleParseString().  Now calls
PyParser_SimpleParseStringFlags() with the correct flag.

Fix SF #441664: Python crash on del of a slice of a mmap

Check for slice/item deletion, which calls slice/item assignment with a NULL
value, and raise a TypeError instead of coredumping. Bugreport and suggested
fix by Alex Martelli.

Revise the description of time.clock() so that it correctly describes the
Windows version of the function as well as the Unix flavor.

This fixes SF bug #441357.

Fix a mismatched parenthesis in the last patch.

Use \longprogramopt, as suggested by FLD

[Bug #441527] Fixes for preprocessor support, contributed by Tarn
    Weisner Burton

Use \verb for configure switches, because inside \code multiple dashes
   are merged to a single hyphen.
Delete forgotten CVS conflict marker

Write some entries in the "Other changes" section
Write description of .encode()/.decode for the Unicode section
Bump version number

Added installation instructions.

Added a patch which modifies idlefork so that it can co-exist with
"official" IDLE in the site-packages directory. This patch is not
necessary if only idlefork IDLE is installed. See INSTALLATION for further
details.

Add a script "idles" which opens a Python Shell window.

The default behaviour of idlefork idle is to open an editor window instead
of a shell. Complex expressions may be run in a fresh environment by
selecting "run".  There are times, however, when a shell is desired.
Though one can be started by "idle -t 'foo'", this script is more
convenient.  In addition, a shell and an editor window can be started
in parallel by "idles -e foo.py".

Ugly.  A pile of new xxxFlags() functions, to communicate to the parser
that 'yield' is a keyword.  This doesn't help test_generators at all!  I
don't know why not.  These things do work now (and didn't before this
patch):

1. "from __future__ import generators" now works in a native shell.

2. Similarly "python -i xxx.py" now has generators enabled in the
   shell if xxx.py had them enabled.

3. This program (which was my doctest proxy) works fine:

from __future__ import generators

source = """\
def f():
    yield 1
"""

exec compile(source, "", "single") in globals()
print type(f())

Call out IDLE Fork in startup message.

Add a script "idles" which opens a Python Shell window.

The default behaviour of idlefork idle is to open an editor window instead
of a shell. Complex expressions may be run in a fresh environment by
selecting "run".  There are times, however, when a shell is desired.
Though one can be started by "idle -t 'foo'", this script is more
convenient.  In addition, a shell and an editor window can be started
in parallel by "idles -e foo.py".

future.c:  insert a cosmetic space.
pythonrun.c, run_pyc_file():  repair semantic error wrt CO_GENERATOR vs
CO_GENERATOR_ALLOWED.

Part way to allowing "from __future__ import generators" to communicate
that info to code dynamically compiled *by* code compiled with generators
enabled.  Doesn't yet work because there's still no way to tell the parser
that "yield" is OK (unlike nested_scopes, the parser has its fingers in
this too).
Replaced PyEval_GetNestedScopes by a more-general
PyEval_MergeCompilerFlags.  Perhaps I should not have?  I doubted it was
*intended* to be part of the public API, so just did.

Began actually writing:
* iterators
* generators
* copied the nested scopes section from the 2.1 article
* standard library changes

Preliminary support for "from __future__ import generators" to enable
the yield statement.  I figure we have to have this in before I can
release 2.2a1 on Wednesday.

Note: test_generators is currently broken, I'm counting on Tim to fix
this.

Remove redundant include of assert.h.

Python.h:  Don't attempt to redefine NDEBUG if it's already defined.
Others:  Remove redundant includes of assert.h.