use_latex():  Hack to pass .syn files though uniq, so that the last module
in a HOWTO document isn't listed in the synopsis table twice.  This
will do until the real bug is found (low priority!).

Added targets dvi, pdf, and ps, to make all of the documents in those formats.

Adjusted to use the new module synopsis support macros.

Adjusted to use the new \declaremodule \modulesynopsis \localmoduletable
macros.

'name space' -> 'namespace'

Lots of new stuff for "module synopsis support."  Public interface consists
of three macros, one which replaces some of the current conventions used in
the module sections:

  \declaremodule:  Requires two parameters: module type (standard, builtin,
extension), and the module name.  An optional parameter should be
given as the basis for the module's "key" used for linking to or
referencing the section.  The "key" should only be given if the
module's name contains underscores, and should be the name with the
underscore's stripped.  This should be the first thing after the
\section used to introduce the module.

  \modulesynopsis:  Requires a single parameter: a short, one-liner
description of the module that can be used as part of the chapter
introduction.  This should probably be placed just after the
\declaremodule, but may be placed anywhere in the same section.

  \localmoduletable:  No parameters.  If a .syn file exists for the current
chapter (or for the entire document in howto docs), a synopsistable
is created with the contents loaded from the .syn file.

Some re-organization due to module synopsis support.

Some \def's changed to \newcommand's.

\py@ModSynopsisFilename:  New macro; gives names of the .syn file.

\py@ModSynopsisFilename:  New macro; gives names of the "current" .syn file.

\chapter:  Extended, ensures that a pending module synopsis is written out
and then closes the .syn file for the preceeding chapter.

Ignore the new ".syn" files used to handle module synopses.

Lots of changes copied from the FrameMaker version.  Also documented
some previously undocumented features.

Several changes to support inclusion of filename in relevent
exceptions:

posix_error_with_filename(): New function which calls
PyErr_SetFromErrnoWithFilename()

The following methods have been changed to call
posix_error_with_filename():

    posix_1str()
    posix_strint()
    posix_strintint()
    posix_do_stat()
    posix_mkdir()
    posix_utime()
    posix_readlink()
    posix_open()

INITFUNC(): os.error (nee PosixError) is PyExc_OSError

PyFile_FromString(): If an exception occurs, pass in the filename that
was used so it's reflected in the IOError.  Call
PyErr_SetFromErrnoWithFilename().

PyErr_SetFromErrnoWithFilename(): New function which supports setting
an exception from errno, with a supplied filename (primarily used by
IOError and OSError).  If class exceptions are used then the exception
is instantiated with a 3-tuple: (errno, strerror, filename).  For
backwards compatibility reasons, if string exceptions are used,
filename is ignored.

PyErr_SetFromErrno(): Implement in terms of
PyErr_SetFromErrnoWithFilename().

Added support for including the filename in IOErrors and OSErrors that
involve a filesystem path.  To that end:

- Changed IOError to EnvironmentError and added a hack which checks
  for arg of len 3.  When constructed with a 3-tuple, the third item
  is the filename and this is squirreled away in the `filename'
  attribute.   However, for in-place unpacking backwards
  compatibility, self.args still only gets the first two items.  Added
  a __str__() which prints the filename if it is given.

- IOError now inherits from EnvironmentError

- New class OSError which also inherits from EnvironmentError and is
  used by the posix module.

Added support for two new standard errors: EnvironmentError and
OSError.  The EnvironmentError serves primarily as the (common
implementation) base class for IOError and OSError.  OSError is used
by posixmodule.c

Also added tuple definition of EnvironmentError when using string
based exceptions.

New global variables: PyExc_EnvironmentError and PyExc_OSError

New function: PyErr_SetFromErrnoWithFilename(PyObject* char*)

# Oops, correct Latex errors.

Document how to make a POST request with urlopen().

Change the argument name for quote() and quote_plus() to safe (which
matches the implementation).

Add doc for the *new* function urlencode().

Speed up the implementation of quote().

Fix the implementation of quote_plus().  (It wouldn't treat '+' in the
original data right.)

Add urlencode(dict) which is handy to create the data for sending a
POST request with urlopen().

- Added a function MoviesTask, which is the same as the method but
with a null movie (giving time to all active movies)
- Made the graphics world parameter to SetMovieGWorld optional.

Remove the MOOV filetype from the StandardGetFile call, so we can also
open MPEG files, etc.

Feature added by Harri Pasanen (at my suggestion): .py suffix on
filename may be omitted.

(pause_doc): Sun CC complains about newline in string literal

When comparing objects, always check that tp_compare is not NULL
before calling it.  This check was there when the objects were of the
same type *before* coercion, but not if they initially differed but
became the same *after* coercion.

Don't use calculations on values gotten from tell().  Also use a
slightly different way to test for the existence of unread.

Add new syntax for specifying filenames on break and clear commands.

Untabified.

Update the documentation.  Get rid of the section "how it works"
(which is not very relevant when you're in the debugger :-).

Added support for specifying a filename for a breakpoint, roughly
according to an idea by Harri Pasanen (but with different syntax).
This affects the 'break' and 'clear' commands and their help
functions.  Also added a helper method lookupmodule().

Also:

- Try to import readline (important when pdb is used from/as a script).
- Get rid of reference to ancient __privileged__ magic variable.
- Moved all import out of functions to the top.
- When used as a script, check that the script file exists.

Fix another bug in ESR's changes.  In order to work properly,
onecmd(line) must return the value returned by emptyline() or
default(line).

Complete the addition of libthreading.tex.  (Isn't it annoying that
you need to edit four files in order to add one section to the manual?)

Add missing initializer for self._backupfilename.  Due to Ralph Butler.

Modest speed improvement to escape() by Piet van Oostrum.

Patch by Piet van Oostrum to avoid calculating with the result of
fp.tell() -- that won't work on Windows.

(A patch for rfc822 is still needed for one case where it finds a bad
header line and wants to back up.)

Add libthreading.tex to LIBFILES.

Added libthreading.tex ; this is mostly the contents of threading_api.py,
 with LaTeX markup added, and some small rewrites to improve the prose.

Measure performance of sub(), split(), findall().

Add test for failure of the getattr call in pcre_expand() -- it used
to core dump if the first argument did not have a "group" attribute.

Get a 3- to 4-fold speedup for sub()/subn(), split() and findall() by
not calling self.search(); instead, call self.code.match() directly
and interpret the list of registers it returns directly.  This saves
the overhead of instantiating a MatchObject for each hit, basically
inlining search() as well as group().  When a MatchObject is still
needed, one is allocated and reused for the duration of the scan.

Added tests for findall().
Added test for m.groups() with default.
Added a few prints announcing various tests in verbose mode.

Eric Raymond documents two already-existing functions (bmp, png).

I_getattr(),
O_getattr():  Added read-only access to the closed attribute, based on comment
from Michael Scharf <Michael.Scharf@Rhein-Neckar.de>.

Add tests for array self-assigns.  (This one has no relevance to JPython.)

Add tests for list self-assigns.  (Sorry, this should have been here
before JPython 1.0 came out.)

Avoid using calloc().  This triggered an obscure bug on multiprocessor
Sparc Solaris 2.6 (fully patched!) that I don't want to dig into, but
which I suspect is a bug in the multithreaded malloc library that only
shows up when run on a multiprocessor.  (The program wasn't using
threads, it was just using the multithreaded C library.)

From: Nicolas CHAUVAT <nico@caesium.fr>

In the bbox method of Group (Canvas.py file), you should read

return self.canvas._getints(self._do('bbox'))

instead of

return self._getints(self._do('bbox'))

Show how to do switchable panels.

Tk.__init__():  In computing baseName, add ".pyo" to list of dropped
extensions, and include the "." in ".pyc".  Still need to get
_tkinter.c:Tkapp_New() to use baseName....

Temporarily get rid of the registration of Tcl_Finalize() as a
low-level Python exit handler.  This can attempt to call Python code
at a point that the interpreter and thread state have already been
destroyed, causing a Bus Error.  Given the intended use of
Py_AtExit(), I'm not convinced that it's a good idea to call it
earlier during Python's finalization sequence...  (Although this is
the only use for it in the entire distribution.)

Better RFC 821 compliance (MAIL and RCPT, and CRLF in data)
by Carey Evans <c.evans@clear.net.nz>, for picky mail servers.

Added a delete() method to menu entries. Only the last entry of a menu
can be deleted, but that's good enough for things like a "Windows"
menu with the dynamic list of open windows at the end of the menu.

Added prototypes for the code resource routines, and for Pstring
(which was missing, for some reason).

If the preference filename resource is empty don't try to open or
create the preferences file. This is so that frozen programs don't
interfere with an existing Python installation, or leave turds in the
Preferences folder.

All import-related code has moved to macimport.c.

There's also new support for importing code fragments: if a file on
sys.path contains a PYD resource with resourcename equal to the name
of the module to be imported this PYD resource should contain a
(pascal) string with the name of a code fragment to load. This allows
freezing Python programs without access to source or a development
environment.

Added macimport.c to various files

Add an empty PYTHONPREFSFILE STR resource, so frozen applications
don't try to open/create the preferences file.

Add special case to PySequence_List() so that list() of a list is
faster (using PyList_GetSlice()).  Also added a test for a NULL
argument, as with PySequence_Tuple().  (Hmm...  Better names for these
two would be PyList_FromSequence() and PyTuple_FromSequence().  Oh well.)

Small changes to map() and filter():

(1) If a sequence S is shorter than len(S) indicated, don't fail --
just use the shorter size.  (I.e, len(S) is just a hint.)

(2) Implement the special case map(None, S) as list(S) -- it's faster.

Changed PySequence_List() and PySequence_Tuple() to support
"indefinite length" sequences.  These should still have a length, but
the length is only used as a hint -- the actual length of the sequence
is determined by the item that raises IndexError, which may be either
smaller or larger than what len() returns.  (This is a novelty; map(),
filter() and reduce() only allow the actual length to be larger than
what len() returns, not shorter.  I'll fix that shortly.)

Added a function SetUserItemHandler: this takes a function(dialog,
item) as parameter and returns a handle suitable for passing to
SetDialogItem as a user-item redraw routine. Note that you can
only make one of these, for now.

Add macros for direct access to the members of CFunction objects.

Move the definition of PyMethodObject to classobject.h, so it can define
macros for more efficient access to the fields.

Marc-Andre Lemburg's patch to move the typedef for PyCFunctionObject
to the .h file and add macros there for inlined access to the fields.

(1) Added a sys.exc_info() emulation.  (It returns None for the traceback.)

(2) Made the test script a bit fancier -- you can now use it to run
arbitrary scripts in restricted mode, and it will do the right thing.
(The interactive mode is still pretty lame; should integrate this with
code.interact().)

Added item about index item/subitem separation.

Fix suggested by Lorenzo M. Catucci <lorenzo@argon.roma2.infn.it> to keep the
large letter at the top of each index section with at least the first entry
for that letter.

# In case BINARY_SUBSCR, use proper PyList_GET* macros instead of inlining.

Marc-Andre Lemburg's patch to support instance methods with other
callable objects than regular Pythonm functions as their im_func.

Reindented some OS/2 and hpux code that looked ugly or at least
inconsistent.

Recompute the special getattr/setattr/delattr cache slots after
changing __dict__ *or* __bases__.

Rewrite to support multiple suckers, each with their own thread.

Instead of printint, use self.message() or self.note().

Needed.

Minor change for windows; set extensions_c later and set
frozendllmain_c at the right place.

Put back the call to report_unbalanced() that was lost when
parse_endtag() was restructured in parse_endtag() and finish_endtag().

# Bump version because of checkin to faqwiz.py. :-(

Don't add <...> around mail addresses; they may already be there.

Added hints about building your own DLL.

Two error messages still used the old name of the functio mkvalue() --
which is now Py_BuildValue().

Add a cast that a picky SGI compiler found was necessary.

Fix a benign problem found by a picky SGI compiler (unreachable break
after a return).

Fix benign problems found by a picky SGI compiler (unreachable break
after a return or goto).

Fix benign problems found by a picky SGI compiler (unreachable break
after a return).

Fix some problems that a picky SGI compiler reported.  Two were benign
(unreachable break after a return) but one was a real bug:
ReadFrames() was getting a bogus framecount because of a missing '&'.

Sigh.  The hack to enable special treatment for errno on SGI machines
must be enabled here, otherwise the errno we set on overflows is not
the errno that's being read by compile.c.  Wonder how many other files
that do their own "#include config.h" need this too :-(

(Because of the structure of autoconf, it's not so simple to get this
into config.h...)

Guess what...

Fix two unrelated problems in the same area:

(1) reorder the tests for -Olimit 1500 and -OPT:Olimit=0 so that the
latter test is performed first, and if it works, the former test is
skipped.  This should get rid of the problem that the new SGI
compilers accept both but emit a warning about -Olimit 1500.

(2) The DGUX hack was somehow split in two by the Olimit tests,
probably as the result of a non-context diff.  Moved this back
together again, after the Olimit tests.

Added copious docstrings, plus two minor layout tweaks.

In the example iterating over sys.argv and opening each argument,
change it to iterate over sys.argv[1:].  Suggestion by Gerry Wiener.

(py-beginning-of-def-or-class, py-end-of-def-or-class,
py-mark-def-or-class): Integrated Michael Ernst latest patches.
Primarily, it allows functions that search or mark defs/classes based
on programmatic specification, to take an 'either flag value which
allows searching for both classes and defs (stopping at the nearest
construct).

Also clean up some docstrings.

(py-comment-indent-function): A replacement for
comment-indent-function's default lambda value (in simple.el), this
version finally kills this nit: auto-filling a comment that starts in
column zero with filladapt turned off would cascade the #'s to the
right.

Now auto-filling seems to work with or without filladapt, and with the
comment starting in any column.

(python-mode): Set comment-indent-function.

Get rid of some obsolete opcodes.

Rewritten a bit to address some criticism in the newsgroup.

Added back the description of the exec statement.  It appears that I
accidentally cut it out when removing the access statement!  Added a
paragraph on __builtins__ and other possible manipulations of the key
space of the dictionaries.  Added some index entries.

The permissions ('mode' flag) should default to 0666.

The _fromlinepattern was a little too restrictive -- some sendmails
don't put the seconds in the time!

# The variable total is never used somehow.  I think I had plans for
# it but can't remember what.  Get rid of a comparison that breaks.

According to Robin Dunn, at least one FTP server returns 200 instead
of 250 on a successful delete.

Normalize markup.

Normalize the markup.