Copy section on generators from the 2.2 document with a bit of rewriting
Add an item

Restructured my pool-management overview in terms of the three
possible pool states.  I think it's much clearer now.

Added a new long overdue block-management overview comment block.

I believe the comments are in good shape now.

Added two comments about possible small optimizations (one getting rid
of runtime multiplications at the cost of a new pool_header member; the
other getting rid of runtime divisions and the pool_header capacity
member, at the cost of a static const vector of 32 uints).

Mention 2.2.1 in intro and in bug/patch counts
Fix two typos spotted by Joonas Paalasmaa

Format strings (tuples,) appropriately

Use attributes appropriately

There is no TestError, use TestFailed appropriately

Update documentation of code objects.

Split the description of co_flags into two paragraphs.  The first
describes the flags that are used for non-future purposes, where
CO_GENERATOR was added.  The second describes __future__'s use of
co_flags and mentions the only one currently meaningful,
CO_FUTURE_DIVISION.

Minor adjustments.

Small fixes for description of function attributes.

func_closure is a readonly attribute.
Add \ttindex{} for func_closure.
Remove discussion of func_closure specific to 2.1.

Reindent. Break long lines. Move comments before the statements.

Use the PyModule_Add*() APIs instead of manipulating the module dict
directly.

Remove all but one use of the module dict.

Remove unused variable and call to PyModule_GetDict().

Switch to using METH_NOARGS where possible.
Convert to use PyModule_*() instead of manipulating the module dict directly.

Remove UNLESS.

New PYMALLOC_DEBUG function void _PyMalloc_DebugDumpStats(void).
This displays stats about the # of arenas, pools, blocks and bytes, to
stderr, both used and reserved but unused.

CAUTION:  Because PYMALLOC_DEBUG is on, the debug malloc routine adds
16 bytes to each request.  This makes each block appear two size classes
higher than it would be if PYMALLOC_DEBUG weren't on.

So far, playing with this confirms the obvious:  there's a lot of activity
in the "small dict" size class, but nothing in the core makes any use of
the 8-byte or 16-byte classes.

We expect to skip the new test_mpz on Windows.

Use the PyModule_*() API instead of manipulating the module dictionary
directly.

Get rid of another use of PyArg_Parse()

Get rid of all METH_OLDARGS & PyArg_Parse.
Fix floating point exception if mpz.powm(10, 1, 0) (modulus == 0).
Add a test.

Remove some now-obsolete generator future statements.
I left the email pkg alone; I'm not sure how Barry would like to handle
that.

Convert file.readinto() to stop using METH_OLDARGS & PyArg_Parse.
Add test for file.readinto().

Hopeful fix for SF bug 503031: urllib.py: open_http() host problem.

I really can't test this, but from reading the discussion in that bug
report, it's likely that this works.  It may also close a whole bunch
of other bug reports related to urllib and proxies on Windows, but who
knows.

mpz_float() only takes one parameter now

Added a "run with commandline Python" flag. Works in MachoPython, should work
in OSX MacPython (untested), and should be disabled/removed in OS9 (but
that doesn't happen yet).

Get rid of warnings due to changing to METH_NOARGS

Use METH_VARARGS rather than METH_OLDARGS implicitly (args are ignored)

Convert METH_OLDARGS -> METH_NOARGS: remove args parameter
Use METH_OLDARGS explicitly rather than implicitly.

Revert use of METH_OLDARGS (use 0) to support 1.5.2

Convert METH_OLDARGS -> METH_VARARGS: also PyArg_Parse -> PyArg_ParseTuple
Please review for correctness.

Remove METH_OLDARGS:
  Convert METH_OLDARGS -> METH_VARARGS: also PyArg_Parse -> PyArg_ParseTuple
  Convert METH_OLDARGS -> METH_NOARGS: remove args parameter
Please review.  All tests pass, but some modules don't have tests.
I spot checked various functions to try to make sure nothing broke.

Convert from using METH_OLDARGS to METH_NOARGS.
These should be safe.

Fix whitespace

Use symbolic METH_VARARGS/METH_OLDARGS instead of 1/0 for ml_flags

Use symbolic METH_VARARGS instead of 1 for ml_flags

Use docstrings for exception classes

Derive exception classes from Exception

Stop using string exceptions

Add one more assert that indirectly interlocking conditions are consistent
with each other.

Fixed an error in a new assert.

Fixed a typo in a new comment.

_PyMalloc_Free():  As was already done for _PyMalloc_Malloc, rearranged
the code so that the most frequent cases come first.  Added comments.
Found a hidden assumption that a pool contains room for at least two
blocks, and added an assert to catch a violation if it ever happens in
a place where that matters.  Gave the normal "I allocated this block"
case a longer basic block to work with before it has to do its first
branch (via breaking apart an embedded assignment in an "if", and
hoisting common code out of both branches).

Added a long-overdue comment block giving an overview of pool operations
and terminology, plus explanation of some extreme obscurities.

Suite to talk to the OSX Terminal application.

Got rid of obsolete way to get at various toolbox types.

Add Mac/Lib/lib-scriptpackages to sys.path too.

Modified to allow it to run in MachoPython in a reasonable way. It still
needs a decent commandline interface, though.

It's once again thought safe to call the pymalloc free/realloc with an
address obtained from system malloc/realloc without holding the GIL.

When the vector of arena base addresses has to grow, the old vector is
deliberately leaked.  This makes "stale" x-thread references safe.
arenas and narenas are also declared volatile, and changed in an order
that prevents a thread from picking up a value of narenas too large
for the value of arenas it sees.

Added more asserts.

Fixed an old inaccurate comment.

Added a comment explaining why it's safe to call pymalloc free/realloc
with an address obtained from system malloc/realloc even when arenas is
still NULL (this is obscure, since the ADDRESS_IN_RANGE macro
appears <wink> to index into arenas).

new_arena():  In error cases, reset the number of available pools to 0.
Else the pymalloc malloc will go insane the next time it's called.

Changed the #-of-arenas counters to uints -- no need to be insane about
this.  But added an overflow check just in case there is.

Got rid of the ushort macro.  It wasn't used anymore (it was only used
in the no-longer-exists off_t macro), and there's no plausible use for it.

Eliminate DONT_SHARE_SHORT_STRINGS.

Patch #536908: Add missing #include guards/extern "C".

Turns out the off_t macro isn't used anymore, so got rid of it.

Now that we're no longer linking arenas together, there's no need to
waste the first pool if malloc happens to return a pool-aligned address.

This means the number of pools per arena can now vary by 1.  Unfortunately,
the code counted up from 0 to a presumed constant number of pools.  So
changed the increasing "watermark" counter to a decreasing "nfreepools"
counter instead, and fiddled various stuff accordingly.  This also allowed
getting rid of two more macros.

Also changed the code to align the first address to a pool boundary
instead of a page boundary.  These are two parallel sets of macro #defines
that happen to be identical now, but the page macros are in theory more
restrictive (bigger), and there's simply no reason I can see that it
wasn't aligning to the less restrictive pool size all along (the code
only relies on pool alignment).

Hmm.  The "page size" macros aren't used for anything *except* defining
the pool size macros, and the comments claim the latter isn't necessary.
So this has the feel of a layer of indirection that doesn't serve a
purpose; should probably get rid of the page macros now.

Retract the claim that this is always safe if PyMem_{Del, DEL, Free, FREE}
are called without the GIL.  It's incredibly unlikely to fail, but I can't
make this bulletproof without either adding a lock for exclusion, or
giving up on growing the arena base-address vector (it would be safe if
this were a static array).

Lots of changes:

+ A new scheme for determining whether an address belongs to a pymalloc
  arena.  This should be 100% reliable.  The poolp->pooladdr and
  poolp->magic members are gone.  A new poolp->arenaindex member takes
  their place.  Note that the pool header overhead doesn't actually
  shrink, though, since the header is padded to a multiple of 8 bytes.

+ _PyMalloc_Free and _PyMalloc_Realloc should now be safe to call for
  any legit address, whether obtained from a _PyMalloc function or from
  the system malloc/realloc.  It should even be safe to call
   _PyMalloc_Free when *not* holding the GIL, provided that the passed-in
  address was obtained from system malloc/realloc.  Since this is
  accomplished without any locks, you better believe the code is subtle.
  I hope it's sufficiently commented.

+ The above implies we don't need the new PyMalloc_{New, NewVar, Del}
  API anymore, and could switch back to PyObject_XXX without breaking
  existing code mixing PyObject_XXX with PyMem_{Del, DEL, Free, FREE}.
  Nothing is done here about that yet, and I'd like to see this new
  code exercised more first.

+ The small object threshhold is boosted to 256 (the max).  We should
  play with that some more, but the old 64 was way too small for 2.3.

+ Getting a new arena is now done via new function new_arena().

+ Removed some unused macros, and squashed out some macros that were
  used only once to define other macros.

+ Arenas are no longer linked together.  A new vector of arena base
  addresses had to be created anyway to make address classification
  bulletproof.

+ A lot of the patch size is an illusion:  given the way address
  classification works now, it was more convenient to switch the
  sense of the prime "if" tests in the realloc and free functions,
  so the "if" and "else" blocks got swapped.

+ Assorted minor code, comment and whitespace cleanup.

Back to the Windows installer <wink>.

Auxiliary files used by BuildApplet for MachoPython.

Auxiliary files for building the IDE applet. Running the IDE through
BuildApplet for MachoPython now seems to do the right thing, yeah!

Handle .icns and .plist files for applets.

Also, for now (until we learn to parse .plist files) we make a special case
for the IDE, setting the creator to "Pide".

Missed one version number.

Use the right types for a couple of fields of the type structure.

Started updating information about defining attributes on types.
There's still a long way to go, but we're starting to see some real
content in the docs.

First stab at an icon for the IDE.

repair damage: canceling the "save options" dialog now works again.

repair damage: now works again as a CFM app.

Completely revamped newline handling. PyEdit is now newline-preserving
(if a single newline convention is used in the sourcefile), and the
"save options" has a newline style radio button.

The creator radio button also has the new choices PythonW and None.

Just: just shout (and revert) if you don't agree.

Allow file without filetype as long as they end in ".py".

Added a -D flag (can really only be specified on OSX commandline) to not
revector sys.stderr, for debugging the IDE itself. Not sure whether
this should stay.

Implemented buildtools for MachoPython .app bundles. The API is compatible
enough that IDE and BuildApplet can create applets, yeah!

Don't attempt to create a dummy fsspec if the user cancelled out, just
return None.

For now, if the user asks for TEXT files files without type are also
accepted. But it is time to phase out StandardGetFile and friends, really.

Re-raise the Res.Error if the file doesn't exist.

Added -Wno-long-double

Changed visible name (in dock, menubar) of the interpreter to PythonW.
Changed version numbers and copyright.

Add missing typecast.

[Patch #536769] Add -Xcompiler flag for adding arguments and switches for
    the compiler

Patch #527027: Allow building python as shared library.

As part of fixing bug #536241, add a test case for string.zfill() with Unicode

[Bug #536241] string.zfill() produces mangled output for a Unicode string.
    Walter Doerwald provided a patch, which I've modified in two ways:

1) (Uncontroversial) Removed code to make module work in earlier versions of
   Python without the unicode() built-in

2) (Poss. controversial) Instead of making string.zfill take the repr()
   of non-string objects, take the str().

Should a warning be added to this branch of the code so that the automatic
str() can be deprecated?

2.2.2 bugfix candidate, assuming the repr()->str() change is deemed OK.

Add two tests for string.zfill

Allow .pyc files as applets as well as .py files. .py files have
priority, for safety reasons.

If the file has no resource fork first check to see whether it's a
datafork-based resource file before trying to decode it as AppleSingle.

Removed debug.

In MachoPython print "Pythonw" in banner to distinguish from command-line
python.
Removed debug output.

Added target "installunixprograms" which installs python and pythonw in
/usr/local/bin (referring to the framework-based interpreter and Python.app).

Added target symlinkmacsubtree to aid in debugging.

Shell script that invokes Python.app from the command line. Called pythonw
because of similarity to the same program on Windows.

Remove the CACHE_HASH and INTERN_STRINGS preprocessor symbols.

Call PyObject_GC_UnTrack before putting an object on the list of trash.

If the GC is enabled then don't use the ob_type pointer to create a list
of trash objects.  Use the gc_prev pointer instead.

Make _PyObject_GC_UnTrack do nothing if WITH_CYCLE_GC is not defined.

News for SF #535905.

Mark a couple of types that had not been marked.

Added comments for more entries of the type structure in the example
type implementation.

The new files included by \verbatiminput in newtypes.tex.

Move some of the longer example code to external fragments, and
include them using \verbatiminput.  This has the advantage that pages
can still break at reasonable places, and examples that go longer than
a page won't get cut off.

Make a few small markup adjustments for consistency.

Explain that PyObject_New() is not a C function but a polymorphic
beast that returns a pointer to the type that's passed as the first
arg.

Explain why type objects use the PyObject_VAR_HEAD.

Fix getcomments() so that it doesn't fail with TypeErrors.

It appears that getcomments() can get called for classes defined in
C.  Since these don't have source code, it can't do anything useful.
A function buried many levels deep was raising a TypeError that was
not caught.

Who knows why this broke...

Added index entries.

Extend \verbatiminput so that the typeset version provides the same appearance
as a verbatim environment.  (The HTML version is already fine.)

new script - helps track down symbols exported by modules but not
mentioned in the library reference manual

test_trashcan:  reword obscure code.

Bugfix candidate.

New test_traschcan() test in test_gc, which reliably provokes segfaults
under 2.0, 2.1 and 2.2.

Bugfix candidate.

Minor wording change.