Expanded docs to have a quick start example showing how
to create and run tests.

supports pthreads

"Support IDLE Edit of .py/.pyw from idlelib"

until now: the inheritance of default values was the wrong way around.
This caused app bundles to get a type of "BNDL" instead of "APPL".
Apparently this is not a problem until you try to drag your app to
the dock.
----------------------------------------------------------------------

record tuple by name as well as index, to match the behaviour of
the pwd/grp extension modules for Unix.  These emulation modules
now pass test_pwd & test_grp.

installation location policies.

Use Py_AtExit instead of atexit so we are called during Py_Finalize()
rather than during DLL teardown.

 * Extended DB & DBEnv set_get_returns_none functionality to take a
   "level" instead of a boolean flag.  The boolean 0 and 1 values still
   have the same effect.  A value of 2 extends the "return None instead
   of raising an exception" behaviour to the DBCursor set methods.
   This will become the default behaviour in pybsddb 4.2.
 * Fixed a typo in DBCursor.join_item method that made it crash instead
   of returning a value.  Obviously nobody uses it.  Wrote a test case
   for join and join_item.

"Break or continue outside loop causes crash"

to have genuwine Windows line ends.

the Perl requirement to 5.6.0 or later.

Remove obsolete reference to deprecated exit_thread() function

markup.  Not currently needed, but easier to save this now than to
have to figure it out when we do.

- don't use \constant for literals; it's for "defined" constants
- fix various consistency issues

example to show how to log to a file.

  detail
- fix minor markup nit

return a tuple.  (this also implies that nobody uses this method; the
bug has been here for a long time)

newline

PyObject_HEAD, not PyObject_VAR_HEAD.