This patch implements relative-path semantics for the "source" facility resembling
those of cpp(1), documents the change, and improves the shlex test main to
make it easier to test this feature.  Along the way, it fixes a name error
in the existing docs.

[Additional documentation markup changes for consistency by FLD.]

Substantial updates to reflect Moshe's Gordon's enhancements to the
module.

Additional changes from Fred to reflect his changes to the module as well.

             and defaults as for filecmp.cmp().  Updated docstring
             accordingly, and formatted it more like others in the standard
             library.

This patch delegates more string functions to string object methods,
uses the varargs delegation syntax, and stops using stringold.

Closes SourceForge patch #100712.

pointed out some of the problems he had following the instructions,
and I stumbled into the others:  MSVC has changed in several
respects, Python has changed the directories into which it builds
its own Windows outputs, and we grew the unusual scheme of
appending "_d" to the names of debug-mode output files.

This should all work with VC6 + CVS Python now.  Some other Windows
geek please confirm!  And the less you know, the better <0.5 wink>.

Explanations and examples for versions of MSVC before 6, and
versions of Python before 2.0b1, have been removed, because
they're too different and so confuse life.  This last step I OK'ed
with Guido first (indeed, 'twas his idea!).

  "lastgroup" is the name of the last matched capturing group,
  "lastindex" is the index of the same group.  if no group was
  matched, both attributes are set to None.

  the (?P#) feature will be removed in the next relase.

Reported on c.l.py by Kirill Simonov.

  used by the code generator)

- changed max repeat value in engine (to match earlier array fix)

- added experimental "which part matched?" mechanism to sre; see
  http://hem.passagen.se/eff/2000_07_01_bot-archive.htm#416954
  or python-dev for details.

Noted by Rob Hooft <rob@hooft.net>.

   speedup for some tests, including the python tokenizer.

-- added support for an optional charset anchor to the engine
   (currently unused by the code generator).

-- removed workaround for array module bug.

- minor comment touchups in the C module

-- changed 1.6 to 2.0 in the file headers

-- fixed ISALNUM macro for the unicode locale.  this
   solution isn't perfect, but the best I can do with
   Python's current unicode database.

Usage error noted by Grant Griffin <grant.griffin@iowegian.com>.

Usage error noted by Grant Griffin <grant.griffin@iowegian.com>.

to 8-bit strings, using the default encoding.

- distutils: Windows installers are already working

- string methods: .join() seems to be the concensus, so it should probably
  be docommented

- filecmp.py supersedes cmp, cmpcache and dircmp

- winreg is completely new: _winreg is an adaptation of what used to be in
  win32api, and winreg is a Python implementation which adds OO syntax.
  Perhaps you know that, but the text is misleading.

Similar to an old bug in ntpath.py.

splittype():  Always lower-case the URL scheme; these are supposed to be
               normalized according to RFC 1738 anyway.

getatime() returned the mtime instead of the atime.
Similar to an old bug in posixpath.py.

Correct typo that caused a well-formedness failure.

They should all be binary (cvs admin -kv has now been applied).