- simplify document structure at one point

- fixed datatype of the values for "handler" attributes
- removed/commented out all mentions of schema component extension;
  that's really not complete and should probably be thought through
  again
- moved docs for legacy API out; these should not be generally
  documented
- misc. small fixes

The manager should raise an exception in its prepare() method rather
than returning a boolean to indicate failure.  Rationale: The txn
manager can't raise a reasonable exception, because it doesn't know
what the data manager couldn't prepare.

It may be reasonable to change this more, but the benefits aren't clear.
(These changes will be used from the new-install-branch.)

make it easier to re-locate an instance.

Don't ever stop after the first object.  It leaves all the other
objects in the version unmodified.

Fix edge case in pack() -- backpointer to object created in version.

pair) from the bucket into the set-iteration struct twice.  I don't
believe this had any visible effect, it was simply pointless and wasted
a little time (discovered by eyeball).

Other than fixes of nonconforming whitespace, just a couple of $Id$
docstrings has been added.

It's not clear what the right answer is here.  The implementation
aborts any remaining resource managers and hopes for the best, which
isn't very satisfying.  Perhaps the hosed feature should come back.

Add some comments about the issues involved.  Revise the tests to
cover the current behavior.

XXX Should the manager duplicate these checks?

Make txn_factory an attribute of the base class.

Raise an exception when prepare() returns False, rather than
automatically aborting.

Pass transaction object to Rollback() so that rollback() method can
check state of transaction.

Add IllegalStateError calls to prevent assertions from failing.
XXX Should the manager duplicate these checks?

Add suspend() and resume() to non-threaded txn manager.

Fix bug that caused threaded suspend() to fail with KeyError for
thread with no current transaction.

classes.

If an error occurs during tpc_finish, save the original exception just
in case something goes wrong while cleaning up the message.

Add suspend() and resume() to transaction manager API.
Change implementation so that the thread-aware manager does not
inherit from the thread-agnostic manager.
Add suspended transaction state.

Increase by iterating for longer, rather than making the delay
longer.  This helps the tests go fast on faster machines.

It's too much work to try to get these tests to work, considering that
we are declaring start.py obsolete with the 3.2 release.

Print repr of description instead of str.

Pederson.  The 'wrap' local variable was reused in a way that
overwrote the value intended to set the return dictionary.

which is used by Barry's new LockFile class.  The effect of leaving
regions of a file locked when closing the file, or when exiting the
process, is undefined on Windows, and the new scheme restricts itself
to operations with defined semantics.

encapsulation the storage lock file.

unlock_file() call which awaits Tim's backport of
winlock.UnlockFile().  This is no-op on *nix.

Also, implement a better API for dealing with lock files.  Use the
LockFile class for clean acquisition and release of locks, and
unlinking of lock files.

- add missing period

- normalize some markup usage