News about from...import.

Two changes to from...import:

1) "from M import X" now works even if M is not a real module; it's
   basically a getattr() operation with AttributeError exceptions
   changed into ImportError.

2) "from M import *" now looks for M.__all__ to decide which names to
   import; if M.__all__ doesn't exist, it uses M.__dict__.keys() but
   filters out names starting with '_' as before.  Whether or not
   __all__ exists, there's no restriction on the type of M.

(Modified) patch by Ping - SF Patch #102681.

- Make error messages from issubclass() and isinstance() a bit more
  descriptive (Ping, modified by Guido)

- Couple of tiny fixes to other docstrings (Ping)

- Get rid of trailing whitespace (Guido)

Change LONG_BIT error warning to mention glibc, too, since this is really
    a glibc, not a gcc, problem.

A variant of SF patch 103028 (Make tempfile.mktemp threadsafe).
Tested on Windows.  Should be tested on Linux.  Should also be
tested on some platform without threads (I simulated that by
making the "import thread" fail, but that's not the same as
actually doing it!).

When compiling for GUSI and Carbon disable te "keep open on unseen output", for the time being.

Disabled a few other routines that are available in CarbonLib.

Added GUSI-Carbon targets (both threading and nonthreading), and they work!! YEAH!!!

Updated descriptions to incorporate additional information from Tim Peters.
This mostly closes SF bug #128251.

Export mmap's entry point under Windows (thanks, MarkH & Guido!).

Document \code{import} in pth files.

Fixed minor markup nits for consistency with the rest of the library
reference.

Conform the new module to /the/ C style.

Noone but me cares, but Guido said to go ahead and fix it if it bothered me.

Delete unused import of pprint module

Typo.

Move the _socket module closer to the SSL-_socket line (mmap and
xreadlines inserted themselves inbetween the two) and clarify that the
normal socket module should be commented out. (Someone also suggested the
latter on c.l.py some time ago, I forget who, sorry.)

Patch #103134: Support import lines in pth files.

Fixed bugs noted by Greg Stein
* x wasn't initialized to NULL
* Did not DECREF result from displayhook function

Added pointer on POP3 variations.

stdout is sometimes a macro; use "outf" instead.

Submitted by: Mark Favas <m.favas@per.dem.csiro.au>

Implementation of PEP-0217.
This closes the PEP, and patch 103170

Corrections and additions to the documentation for POP3 and IMAP library
support, based on my fetchmail experience.

Add missing Py_DECREF in fast_cfunction.  Partial fix for SF bug
#127699.

SF Patch #102357 by bbum: Add support for frameworks and objective-c
source. Uesful for both GnuStep and for OSXS/OSX/Darwin.

(Note: I changed $(CCC) to $(CXX) since that's now the name of the C++
compiler.  Please test!

SF Patch #102362 by bbum: Support dynamic module loading under OSX
[including support for modules w/Objective-C].

Oops, one more part of the cygwin patch (SF patch #102409 by jlt63:
Cygwin Python DLL and Shared Extension Patch).  Add module.dll as a
valid extension.

jlt63 writes: Note that his change essentially backs out the fix for
bug #115973. Should ".pyd" be retained instead for posterity?

Final part of SF patch #102409 by jlt63: Cygwin Python DLL and Shared
Extension Patch.

These are the changes to the Modules Makefile and makesetup script for
Cygwin.

Part of SF patch #102409 by jlt63: Cygwin Python DLL and Shared
Extension Patch.

Note: this could use some testing on NeXT, DG/UX, or BeOS, because of
the changes in the Makefile regarding $(LDLIBRARY).

Part of SF patch #102409 by jlt63 to support building these modules
under CYGWIN as shared libraries (DLLs).

SF Patch #103154 by jlt63: Cygwin Check Import Case Patch.

Note: I've reordered acconfig.h and config.h.in to obtain alphabetical
order (modulo case and leading _).

Added a whole slew of news items.  Not striving for completeness --
I've skipped all bugfixes, Unicode, distutils changes.  But this
should be a start!

SourceForge patch #103140, checked in at fdrake's invitation. Minor fixes and
additions to library docs.#

Adapted version of SF Patch #103173 by pyretic: make uu.decode work
with spaces in filename.

I changed the module to use string methods instead of the string
module.  Also, instead of stripping the last character of the filename
(assuming this is the linefeed), I strip trailing whitespace (assuming
creating files with trailing whitespace in their name cannot possibly
be a wise idea).

(Note that I believe that /F's "workaround for broken uuencoders" is
no longer needed since the recent fix to binascii.c, but I'll leave it
in since it appears pretty harmless.)

Adapted version of Eric Raymond's patches to automatically configure
curses and readline (for Linux, at least).

These are done as shared libraries by default, and so is bsddb -- that
seems to make the most sense.

Add loop.c -- a test program for repeatedly calling Py_Initialize()
and Py_Finalize().  It seems to dump core right now...

Fix weird typo caused by ANSIfication (nobody bothered to test it
since! :-( ).

Moved the test codec definition to a new module and updated the test and
codec to test all charmap codec features.

As side-effect of moving the test codec into a new module, the encodings
package codec import mechanism is checked as well.

Windows mmap should (as the docs probably <wink> say) create a mapping
without a name when the optional tagname arg isn't specified.  Was
actually creating a mapping with an empty string as the name.

Fix a typo, remove one copy of a duplicated name.

Make Windows build compile new xreadlinesmodule.

Assorted xreadlines problems:
    Wasn't built on Windows; not in config.c either.
    Module init function missing DL_EXPORT magic.
    test_xreadline output file obviously wrong (started w/ "test_xrl").
    test program very unclear about what was expected.

Remove bogus "echo" command.

Added documentation for the xreadlines module & related changes.  The
documentation was written by Jeff Epler (thanks!).

Resurrected Small Carbon Python as a target in PythonStandSmall. Still no GUSI, though, so no socket/select/threads.

FSSpec names may be longer on carbon (1024 chars), cater for that in buffer sizes.

Don't need to define c2pstrcpy() on Carbon: it's in CarbonLib.

If we're not using GUSI the "keep open on unseen output" becomes the same as "always keep open".

Carbon defines {Get,Set}ControlDataHandle, so unfortunately our variants on {Get,Set}ControlData have gotten an underscore: GetControlData_Handle, etc.

Carbon defines {Get,Set}ControlDataHandle, so unfortunately our variants on {Get,Set}ControlData have gotten an underscore: GetControlData_Handle, etc. This is an incompatible change:-(

Various tweaks to make it everything build and compile again under carbon. Mainly greylisted functions.

Added a --global-module-index option to specify a (possibly relative) URL
to the Global Module Index for a set of documents.  This is used to include
a reference to the global index from the per-document module indexes, so
that it is just a little easier to find.

(Someone suggested this, but I do not remember who.  Please let me know if
it was you -- thanks!)

Jeff Epler's patch adding an xreadlines() method.  (It just imports
the xreadlines module and lets it do its thing.)

Test for xreadline.

Jeff Epler's xreadlines module, with slight reformatting and some
changes for safety and tuning.

Miscellaneous updates.

Steve Holden <sholden@holdenweb.com>:
Clarify the handling of characters following backslashes in raw strings.

Added names.

Added missing word; fixed minor nits.

Added entry for fpectl module documentation.

Moved the mutex docs to be adjacent to the sched docs, since these are
meant to be used together (if they are used at all!).

Added entry for fpectl module documentation.

Documentation for the fpectl module, from Lee Busby.  (Thanks!)

Check in patch #102971: if library_dirs is a string, split it using
   os.pathsep

Patch #102953: Fix bug #125452, where shlex.shlex hangs when it
    encounters a string with an unmatched quote, by adding a check for
    EOF in the 'quotes' state.

Address a bug in the uuencode decoder, reported bu "donut" in SF bug
#127718: '@' and '`' seem to be confused.

Tsk, tsk, tsk.  Treat FreeBSD the same as the other BSDs when defining
a fallback for TELL64.  Fixes SF Bug #128119.

Remove configure test for getline(), since it's no longer used at all

Anonymous SF bug report #128053 point out that the #ifdef for
including "tmpfile" in the posix_methods[] array is wrong -- should be
HAVE_TMPFILE, not HAVE_TMPNAM.

Explain that long options are matched based on a unique prefix rather than
requiring the whole option to be typed out.

This closes SF bug #126863.

GetoptError is always initialized with exactly two parameters, so simplify
the constructor.

Fixed bug which caused HTTPS not to work at all with string URLs

Fix a silly bug in float_pow.  Sorry Tim.

The Python/C API deals in PyObject*, not PyDictObject*.

Text.__init__():  Make sure the data parameter is a string (8-bit or
                  Unicode); raise TypeError if not.

This closes SF bug #126866.

A few reformats; no logic changes.

Let's hope that three time's a charm...

Tim discovered another "bug" in my get_line() code: while the comments
said that n<0 was invalid, it was in fact still called with n<0 (when
PyFile_GetLine() was called with n<0).  In that case fortunately
executed the same code as for n==0.

Changed the comment to admit this fact, and changed Tim's MS speed
hack code to use 'n <= 0' as the criteria for the speed hack.

18 isn't a prime (duh).

Fiddled ms_getline_hack after talking w/ Guido:  made clearer that the
code duplication is to let us get away without a realloc whenever possible;
boosted the init buf size (the cutoff at which we *can* get away without
a realloc) from 100 to 200 so that more files can enjoy this boost; and
allowed other threads to run in all cases.  The last two cost something,
but not significantly:  in my fat test case, less than a 1% slowdown total.
Since my test case has a great many short lines, that's probably the worst
slowdown, too.  While the logic barely changed, there were lots of edits.
This also gets rid of the reference to fp->_cnt, so the last platform
assumption being made here is that fgets doesn't overwrite bytes
capriciously (== beyond the terminating null byte it must write).

MS Win32 .readline() speedup, as discussed on Python-Dev.  This is a tricky
variant that never needs to "search from the right".
Also fixed unlikely memory leak in get_line, if string size overflows INTMAX.
Also new std test test_bufio to make sure .readline() works.

Tim noticed that I had botched get_line_raw().  Looking again, I
realized that this behavior is already present in PyFile_GetLine(),
which is the only place that needs it.  A little refactoring of that
function made get_line_raw() redundant.

Add more regression tests, including for the import statement variations.
These will detect regression on SF bug #127271 and other import statement
bugs.

Fix problems with validation of import statement parse trees.
This closes SF bug #127271.

This patch adds a new feature to the builtin charmap codec:

the mapping dictionaries can now contain 1-n mappings, meaning
that character ordinals may be mapped to strings or Unicode object,
e.g. 0x0078 ('x') -> u"abc", causing the ordinal to be replaced by
the complete string or Unicode object instead of just one character.

Another feature introduced by the patch is that of mapping oridnals to
the emtpy string. This allows removing characters.

The patch is different from patch #103100 in that it does not cause a
performance hit for the normal use case of 1-1 mappings.

Written by Marc-Andre Lemburg, copyright assigned to Guido van Rossum.

This patch adds a new feature to the builtin charmap codec:

The mapping dictionaries can now contain 1-n mappings, meaning
that character ordinals may be mapped to strings or Unicode object,
e.g. 0x0078 ('x') -> u"abc", causing the ordinal to be replaced by
the complete string or Unicode object instead of just one character.

Another feature introduced by the patch is that of mapping oridnals to
the emtpy string. This allows removing characters.

The patch is different from patch #103100 in that it does not cause a
performance hit for the normal use case of 1-1 mappings.

Written by Marc-Andre Lemburg, copyright assigned to Guido van Rossum.

Added "repeat.py" -- repeatedly execute a shell command (like
watch(1)).  Updated and untabified the README file.

Configuration test for working getc_unlocked() (and flockfile() and
funlockfile()).

Speed it up by using readlines(sizehint).  It's still slower than
other ways of reading input. :-(

In the process, I added an optional bufsize argument to the input()
function and the FileInput class.

Restructured get_line() for clarity and speed.

- The raw_input() functionality is moved to a separate function.

- Drop GNU getline() in favor of getc_unlocked(), which exists on more
  platforms (and is even a tad faster on my system).

Clarification of new bisect module functions.

Update explanation of the set_location() method to indicate that in
BTree databases, the key need not be in the database.  Also, tell about
the exception if the key is not in the DB for other DB types.

This closes SF bug #127377.

Add test cases based on RFC 1808.  So now we actually have a test suite
the urljoin() function, which exercises the urlparse() and urlunparse()
functions as side effects.

(Moshe, why did we have perfectly empty tests checked in for this?)

urlunparse():  Do not add a leading slash to the path if it is empty.

urljoin():  Make this conform to RFC 1808 for all examples given in that
            RFC (both "Normal" and "Abnormal"), so long as that RFC does
            not conflict the older RFC 1630, which also specified
            relative URL resolution.

This closes SF bug #110832 (Jitterbug PR#194).

Fix signed/unsigned wng.  Unfortunately, (unsigned char) << int
has type int in C.

When a PyCFunction that takes only positional parameters is called with
an empty keywords dictionary (via apply() or the extended call syntax),
the keywords dict should be ignored.  If the keywords dict is not empty,
TypeError should be raised.  (Between the restructuring of the call
machinery and this patch, an empty dict in this situation would trigger
a SystemError via PyErr_BadInternalCall().)

Added regression tests to detect errors for this.

Recognize pyc files even if they don't end in pyc.
Patch #103067 with modifications as discussed in email.

Fix the bugfix for SF bug #127151 -- make sure we map "previous_page" to
"previous" and "next_page" to "next".  This way the proper icons are found.

__rcmp__() description:  Changed to indicate that this is no longer
                         supported as of Python 2.1.  We still need to
                         have an entry for this since it is reasonable
                         for users to want to understand existing code.

This closes SF bug #122715.

Based on comments from Guido, do not describe bisect() and insert() as
being "for backward compatibility."  Also revert to using bisect() in the
example, since Guido thinks that is the best recommendation for typical
usage.

Markup nit:  Command line options should be marked with \programopt.

Other minor markup nits fixed.

Make reference to PyErr_Warn() a hyperlink.

Markup nit:  Command line options should be marked with \programopt.

Fix typo spotted by Detlef Lannert <lannert@users.sourceforge.net>.