(py-outdent-p): When looking at the previous line, watch out for
continuation lines.  This fixes this bug report, reported by Frank
Stajano.

# But if I split the "raise" line and reindent, the else WRONGLY goes up a
# level (?!?)

while condition1:
    if condition2:
        raise error3, \
              moreInfo4
else: # meant to close "if condition2"
    action5()

(py-goto-initial-line): Shut up the byte compiler.

(py-mode-map): Add a binding of C-m to py-newline-and-indent.  This is
a religious issue: RMS decrees that the Enter (RET) key should just do
a newline and a LFD (C-j) should do a newline and indent (i.e. the
python-mode version of this).  Almost everyone I know disagrees and
finds that RET should do newline and indent.  Almost everyone hacks
their modes to do this, if they know how.  Because it's hard for
newbies to figure out how to do this, and because most DOS keyboards
lack a LFD (leaving users to the more obscure C-j), I think it makes
better sense to add this default binding.

Add entry for copy_reg module.

Removed entry for copy_reg module.

$(LIBFILES):  Added libcopyreg.tex.

Add entry for copy_reg module.

Simple documentation of the copy_reg module.

Guido, you should probably look at this.  The pickle documentation is out of
date; I don't see anything about the __reduce__() stuff or the
__safe_for_unpickling__ attribute.

Update comment about relative URL internet draft to reflect current RFC status;
index references the appropriate RFCs.

Consistency:  Always use trailing "()" on function names in running text.

(py-compute-indentation): In the most common case, where indentation
is based on the line above, watch out for landing inside a triple
quoted string.  In this case, use iterative search +
parse-partial-sexp backwards to find the beginning of the string.

Note this does affect performance, but very little in the common cases
(I hope).  It could be made *much* faster by adding Emacs and XEmacs
dependent code -- different code naturally.  :-(

Fixes the following reported bug:

if len(sys.argv) >= 6:
    # More lines here
    fptr = open('/etc/hosts', 'w')
    fptr.write("""# /etc/hosts -- autocreated by /etc/ppp/ip-up
#
# Address from pppd
%-15s %s

# For loopbacking
127.0.0.1 localhost

255.255.255.255 broadcast
""" % (ipaddr, ipname) )

os.chmod('/etc/hosts', 0644)

(py-master-file): New buffer-local variable which can be set in the
file local variable section of a file.  When set, and the user hits
C-c C-c, this file gets executed instead of the buffer's file.  Idea
given by Roy Dragseth <royd@math.uit.no>, but implemented differently.

(py-execute-buffer): Support py-master-file variable.  If this names a
relative path, default-directory is prepended via expand-file-name.

Added a bunch of "concept" index entries.

Use trailing "()" on function names in running text.

Added index entry and \label{} for exceptions module.  This isn't in the
normal modules portion of the manual, but that's the basic effect of this
section with the 1.5 change in exception support.

Always mark variables in the "Notes" following a table the same way as in the
tables:  \var{}

Add a couple of index entries to the File Objects section.

Removed bogus index entry for the type() built-in.

Marked title of the Python Reference Manual as \emph{}, like other Python
manual titles.

Proposed new macros:  see comments.  These are not yet used.

These are intended to support semantic markup.  There are a number
of places in the documentation where the exact meaning of an
indentifier marked \code{} in the running text is ambiguous (could
be a module or a class, a function or a method, etc.).  These are
intended to clarify the intent of the identifier for processing
applications and more intelligent style processing.

Consistency:  "{\tt ...}" ==> "\code{...}"

Consistency:  "{\it ...}" ==> "\emph{...}"

The soundex module is built-in, not standard.

"--" ==> "---"

Consistency:  {\it ...} ==> \emph{...}

ni is a standard module, not a built-in module.  The only other reference to
it already got it right.

Consistency:  (Yes, I know this section is not formatted by default, and
      isn't likely to be of much interest these days....)

{\tt ...} ==> \code{...}

Added \label{module-blat} for the two supporting modules.

Added index entries for referred-to modules.

Renamed Jim's PyErr_[JF]Format() to cPickle_ErrFormat().  It's not a
standard Python API function so it should not have a Py prefix.

Removed a confusing note about coercions and __r*__ operators.

Various updates to the effect that the group argument is always optional.
Also documented that groups() now always returns a tuple.

Add note about dropping latex 2.09 compatibility.

Revamped, to match py_compile.py:

- added docstrings
- support option to specify a different purported directory name
- reindented with 4 spaces

Add Gopher to list of protocols that support query strings.

Fix bad new bug in ftp code -- the test for existing file using NLST
would set the transfer to text mode instead of the specified mode.

Fix to ismount().  Can't remember who told me this.

Patch by Tim O'Malley for servers that send a response looking just like
    HTTP/1.x 200
instead of
    HTTP/1.x 200 OK

Protect PyErr_Format format string argument from overflow.

Protect PyErr_Format format string argument from overflow (ironically,
the error was about a bad format string :-).

Instead of "attribute-less object", issue an error message that
contains the type of the object and name of the attribute.

tok_nextc() should return unsigned characters, to avoid mistaking
'\377' for EOF.

Instead of a single exists(), differentiate between files, modules,
executable files, and directories.  When expecting a module, we also
look for the .pyc or .pyo file.

Add unistd.h for isatty().

Add LOG_SYSLOG if defined.

Better #ifdefs for NetBSD, taking into account that at least on netBSD
1.3, dlopen() etc. are fully implemented, including dlerror().
From Jaromir Dolecek and Ty Sarna.

It seems obvious that when Py_Finalize() decides that there's nothing
to do, it should not call sys.exitfunc either...

Some patches by Lars Marius Garshol:

- fix type_to_name(); it never worked
- add path_to_selector()
add path_to_datatype_name()

Rewritten PyImport_Cleanup() and its helper, clear_carefully().  They
now implement the following finalization strategy.

1. Whenever this code deletes a module, its directory is cleared
   carefully, as follows:
   - set all names to None that begin with exactly one underscore
   - set all names to None that don't begin with two underscores
   - clear the directory

2. Modules are deleted in the following order:
   - modules with a reference count of 1, except __builtin__ or __sys__
   - repeat until no more are found with a reference count of 1
   - __main__ if it's still there
   - all remaining modules except __builtin__ or sys
   - sys
   _ __builtin__

Consistency:  Replaced 4 {\it ...} with \emph{...}.

Added docstrings.

Added an optional third parameter giving the purported filename for
error messages from the module.

Append a newline to the code string if needed.

Consistency: Replaced one {\tt ...} with \code{...}.

Consistency:  In two places, change {\it ...} to \emph{...}.

Consistency:  In two \section{} headers, change {\tt ...} to \sectcode{...}.

\funcitem{}, \dataitem{}, \excitem{}:  Removed obsolete macros; there are no
longer used anywhere.  Use the {*desc} environments instead.

\var{}:  Ensure that the argument is always set in roman italic, in case an
 alternate font is being used for code.  These keeps the result of
 \var{} consistent.

Some minor changes to allow easier exploration of alternate fonts for code in
the running text.  Haven't changed the selected font; I haven't found one that
has everything required!  (The best non-monospaced font so far was missing
the <, >, and | characters, or at least had them at the wrong locations.  It
also allowed confusion between upper-case I and lower-case L.)

Use \emph{} for all references to the other documents, not just some of them.

Mods by Bill Bedford
- Use internal version of finder class so we don't drag in finder
  tools
- error -1704 also ignored during arg unpack
- Use Scriptable Text Editor for example

Addition by Bill Bedford: Ordinal and NOrdinal classes so we can
implement "every", etc.

SO_REUSEPORT should be SO_REUSEADDR.
I found this in a mail of two and a half years ago from Yusuf Goolamabbas.

Ouch:  "accounces" ==> "announces"

(In description of AbstractWriter class.)

Add trace methods to class Variable

Added tests for qualified sub and split

Seems I've found a way to fix this.

Consistency:  "{\bf ...}" ==> "\strong{...}"
      "{\em ...}" ==> "\emph{...}"

      Not at all sure what to do with "{\rm ...}".
      Leaving it for now.

Added the standard \label{module-*} for the two supporting modules.

Consistency:  "Unix" ==> "\UNIX{}"
      Always include the comma *inside* the \optional{} markup!

Augment \tableofcontents to do the right thing.

Removed \mytableofcontents; just use \tableofcontents.

Removed one hack!

Consistency:  "Unix" ==> "\UNIX{}"

Consistency:  "unix" ==> "\UNIX{}"

Some shifting around of the DGUX hack so that it won't break on DEC Unix
where Make doesn't know that '#' as a command is a comment.

Consistency:  "unix" ==> "\UNIX{}"

Added \label{} for referring to the module.

Consistency:

"Unix" ==> "\UNIX{}"

Deleted targets used only by Jim Fulton's now deleted "gMakefile".

Also change the build rules to use $(LIBRARY) instead of
  -L.. -lpython$(VERSION)
since the latter trips up the SunOS 4.1.x linker (sigh).

Consistency:

"Unix" ==> "\UNIX{}"

"C" ==> "\C{}"

"C++" ==> "\Cpp{}"

delete gMakefile, clarify Makefile.pre.in

No longer needed, sez Jim.

Consistency:

"Unix" ==> "\UNIX{}"

"C" ==> "\C{}"

"C++" ==> "\Cpp{}"

Removed obsolete \kwindex{} call.

Added "user configuration file", ".pythonrc.py file" to the index.

Made reference to site module a {seealso} environment.

Added "module search path" to the index.

Removed obsolete \kwindex{} calls.

Added "module search path" to the index.

"Unix" ==> "\UNIX{}"

Update the doc string to emphasize non-Unix behavior earlier;
sys.prefix is no longer empty on any platform that I know of.

\kwindex{}:  Removed obsolete macro.

&do_cmd_kwindex:  Removed obsolete function.

Added command at end to use times fonts; commented out.  Instructions to use
times are there as well.

Doing it here means the switch only affects one file and gets everything
rebuilt as needed.

Removed tarps2, tardvi targets based on comments from Guido.

Added -9 option to gzip.  This doesn't save much space, but it's "free" and
appreaciated by those with slow modems.  (With these tarballs, that means
"those with modems"...!)

Remove the two tarballs in the clean target.

After discussion with Guido, agreed to only support double-sided PostScript,
so we'll not need this shell whackery after all.

Added openright option the the \documentclass{} for each of the manuals.

Added targets:

  tarps - one-sided PostScript
  tarps2 - two-sided PostScript, with ref.ps added as-is.
  tardvi - yes, some people want the .dvi files

  all-ps2 - Create the .ps files, but make sure the LaTeX openright option
    is used in the \documentclass.

Script to add & remove LaTeX \documentclass options.  Run "./texoption.sh"
for usage information.

&make_mod_index_entry:  Wrap a long comment, store the additional data needed
to create a module index in the HTML version.

Override several functions from the stock latex2html to support the module
index.  It works, it's ugly, and would probably have to be completely redone
if we changed latex2html versions.  See the comments.  ;-(

On the other hand, it works.  ;-)

(Wait for myformat.perl checkin as well.)

Added support for \funcline{} and \dataline{}.

For all generated cases of <strong>...</strong> (from this module), change to
<b>...</b>.  This, from me?  This is entirely to reduce the size of the
generated markup, which is more of an issue than semantics here.  Since
<strong> isn't very meaningful anyway, this should be good.

Lots of minor markup nits, all consistency related.

Consistently use trailing "()" on function / method names.

Wrapped some long lines.

Document maxsplit arg for split(), with incompatibility note about 1.5
release bug.

Document groups() changed behaviour (now always returns tuple).

Fix two bugs:

(1) maxsplit was ignored in split().

(2) groups() would return a string instead of a singleton tuple when
there was only one group.

Wrapped some long lines.

Added trailing "()" for function and method names.

Added index entries for referenced modules.

Modify command descriptions to use \optional{} instead of ad-hoc markup.
There are still weirdnesses, but less of them.

\optional{}:  Removed leading word space, allowing more flexibility.

{seealso} environment:  Always start a new paragraph after the "See Also:"
line; this ensures that formatting is consistent for each subsequent
\see*{} item.

Sigh.  Apply a similar patch to the *other* occurrence of [^...].

Follow current recommended practice in an example:  Use isinstance() to
perform a type test instead of type(x) == types.FoobarType.  In example
for type().

"Unix" --> "\UNIX{}"

Added index references to referred-to modules.

Added seealso section pointing to the glob module.

Removed description of translate().

As Jeff painfully found out, malloc(0) returns NULL on OS/2.

Grammatical nit.

Add module reference for cPickle to index.

Consistency:  Always use trailing "()" for function and method names in text.

Consistency:  Always mark parameter names with \var{} in text.

Change questionable text about CORBA to definate text about XDR; "CORBA" isn't
enough to specify an external representation, and I'm not sure the comment is
right if we say "IIOP".  I know its right about XDR if we only mention shared
object references and not recursive structures.

Use \file{} instead of \code{} or ``\code{}'' to mark file & directory names
& name parts.