brief help file for people editing Misc/NEWS

ReST-ification of the NEWS file.  While the total number of changes are
fairly large, most are caused by reformatting section and subsection
headings.  The changes fall into the following categories:

    * reformatted section and subsection headers.

    * escaped isolated asterisks which would be interpreted as starting bold
      or italic text (e.g. "void (*)(PyObject \*)").

    * quoted stuff that looks like internal references but isn't
      (e.g. ``PyCmp_``).

    * changed visually balanced quotes to just use apostrophes
      (e.g. "'string'" instead of "`string'").

    * introduced and indenting multiline chunks of code.

    * created one table (search for "New codecs").

Fiddle comments and variable names in whichmodule().

whichmodule() should skip dummy package entries in sys.modules.

This fixes the charming, but unhelpful error message for
>>> pickle.dumps(type.__new__)
Can't pickle <built-in method __new__ of type object at 0x812a440>: it's not the same object as datetime.math.__new__

Bugfix candidate.

SF Bug #611225.
Bring idle.pyw into alignment with idle.py, eliminate calling deleted
module IdleConf.py

Fix a problem in site.py which triggers in case sys.path is empty.

Bugfix candidate for 2.2.2.

Patch #484994: Improve PanedWindow.

Patch #608999: Fix portability problems with MIPSPro 7.x

Suppress hex/oct constant warnings in <string> on 64-bit platforms,
because there test_grammar.py pulls them out of strings there.

Two more cases of switch(PySequence_Size()) without checking for case -1.
(Same problem as last checkin for SF bug 610610)
Need to clear the error and proceed.

Backport candidate

Open the test files in binary mode so the \r\n files won't cause
failures on Windows.  Closes SF bug # 609988.

Merge Py Idle:
Removing config-mac.txt, not used in Idlefork

Merge Py Idle changes:
Missed adding "import types" while merging PyShell by hand....

Add MJ.

Fix SF bug 610610 (reported by Martijn Pieters, diagnosed by Neal Norwitz).

The switch in Exception__str__ didn't clear the error if
PySequence_Size() raised an exception.  Added a case -1 which clears
the error and falls through to the default case.

Definite backport candidate (this dates all the way to Python 2.0).

Merge Py Idle changes:

Rev 1.4 fdrake
Use string.ascii_letters instead of string.letters (SF bug #226706)

Rev 1.5 doerwalter
(string methods)

Merge Py Idle changes:

Rev 1.6 GvR
Finally fix SF bug #441172, using a variant of patch ##443626:
canceling an edit operation would not revert the value of the field.
The fix takes care to destroy the Entry object, as suggested in the
patch.

Rev 1.7 Geiger Ho / GvR
(previously applied - Idlefork Rev 1.3)

Rev 1.8 doerwalter
(string methods)

Merge Py Idle changes:

Rev 1.3 nnorwitz
Remove unnecessary imports

Merge Py Idle changes:

Rev 1.17 doerwalter
(string methods)

Merge PyIdle changes:
Rev 1.3 doerwalter
(string methods)

Merge Py Idle changes:

Rev 1.2 doerwalter
(string methods)

Merge Py Idle changes:

Rev 1.3 tim_one
Convert a pile of obvious "yes/no" functions to return bool.

Merge Py Idle changes:

Rev 1.11 GvR
Fix for SF bug #448835.

Fix this to work with the new (still undocumented) tabnanny API.

I'm afraid Stephen will have to add this fix to the IDLE fork code
base as well.

Rev 1.12 rhettinger
(skip, done differently in Idlefork)

Rev 1.13 time_one
(skip, NA)

Merge Py Idle changes:

Rev 1.5 tim_one
Convert a pile of obvious "yes/no" functions to return bool

Rev 1.6 GvR
Rev 1.7 Gvr
(Already merged Idlefork ReplaceDialog.py 1.3.2.1 and 1.4)

Rev 1.8 doerwalter
(string methods)

Rev 1.9 nnorwitz
Remove unnecessary imports

Merge Py Idle changes:

Rev 1.35 fdrake
Use string.ascii_letters instead of string.letters (SF bug #226706).
Move computation of sets of characters out of the body of the function
that uses them.

Rev 1.36 tim_one
Convert a pile of obvious "yes/no" functions to return bool

Rev 1.37
(skip, done differently in Idlefork)

Rev 1.38 loewis
Patch #590913: PEP 263 support.

Rev 1.39 loewis
Convert characters from the locale's encoding on output.
Reject characters outside the locale's encoding on input.

Rev 1.40 doerwalter
(string methods)

Rev 1.41
(skipped, done by GvR in rpc)

The SGI demos are gone.

Remove the SGI demos.  These were all ancient and nobody cared enough.

migrate news about 2.1 and earlier releases from NEWS to HISTORY in
preparation for ReST-ification of NEWS.  (Also tests checkin ability
from my new Powerbook.  woohoo!)

Remove the SGI demos.  These were all ancient and nobody cared enough.

write():  Special case the common situation of a stream that's only
          being used to dump output (no seeks), so we can avoid a lot
          of extra checks being made.

Fix typos: despatcher -> dispatcher.

Deal with NULL fields in mkpwent.

Deal with a NULL gr_passwd. Reported by Anders Qvist.

Merge Py Idle changes:
Rev 1.10 doerwalter
(string methods)

Merge Py Idle changes:
Rev 1.6 doerwalter
(string methods)

Merge Py Idle changes:
Rev 1.7 loewis
Convert characters from the locale's encoding on output.
Reject characters outside the locale's encoding on input.

Back out the previous change.  It doesn't save any space on 64-bit
platforms.

Rearrange the members of struct _node to put shorter fields towards
the end, in the hope of saving some bytes on 64-bit machines.  (Too
bad n_nchildren can't be made an unsigned short, but
test/test_longexp.py specifically tests for more than 2**16 subtrees
at one level.)

I don't expect any binary compatibility issues here, unless someone
has an old binary of parsermodule.so saved away.

Merge Py Idle changes:
Rev 1.4 tim_one
Convert a pile of obvious "yes/no" functions to return bool

Merge Py Idle changes:
Rev 1.5  doerwalter
string methods

Merge Py Idle changes:
Rev 1.5 tim_one
Convert a pile of obvious "yes/no" functions to return bool.

Rev 1.6 gvanrossum
(partially merged previously, move line outside try: block)

Provisional fix for writefile() [SF bug # 541730].

The problem was that an exception can occur in the text.get() call or
in the write() call, when the text buffer contains non-ASCII
characters.  This causes the previous contents of the file to be lost.

The provisional fix is to call str(self.text.get(...)) *before*
opening the file, so that if the exception occurs, we never open the
file.

Two orthogonal better solutions have to wait for policy decisions:

1. We could try to encode the data as Latin-1 or as UTF-8; but that
   would require IDLE to grow a notion of file encoding which requires
   more thought.

2. We could make backups before overwriting a file.  This requires
   more thought because it needs to be fast and cross-platform and
   configurable.

Rev 1.7 gvanrossum
(previously merged with modifications by Stephen M. Gava)

Add primitive printing support for Unix and Windows.

Rev 1.8 loewis
Patch #590913: PEP 263 support.

Rev 1.9 gvanrossum
(tempfile.py interface -- deferred)

Rev 1.10 tim_one
whitespace normalization

Rev 1.11 nnorwitz
(deferred pending 1.9 integration)

make sure the object browser can't crash because when the list data gets bigger than 32kB

add ./ to configure command so it actually works verbatim

Patch #609700: Use $(CC) to link on Linux.

Make BadPickleGet a class. Fixes #609164.

When recursively attempting to find the modules imported by an
"import" statement, catch and ignore all exceptions.  add/fix some
comments about this.

Merge Py Idle changes:
Rev 1.4 (string methods)

Rev 1.5 Remove unnecessary imports

Merge Py Idle changes:
Rev 1.10 (string methods)

Merge Py Idle changes:

Rev 1.39 GvR
Properly fix SF bug #507298 (Gregor Lingl): shellpython2.2 -Qnew smart
indent error

Use // where int division is intended.  (This breaks IDLE for use with
previous Python versions -- I don't care.)

Rev 1.40 tim_one
Convert a pile of obvious "yes/no" functions to return bool.

Rev 1.41 foffani/loewis
(already merged)  - MS html help

Rev 1.42
(skip, done differently in Idlefork)

Rev 1.43 tzot/rhettinger
Extended IDLE's open module menu item to handle hierarchical module names.
Will look at doing something similar in import.c so that the effort won't
have to be repeated elsewhere.
Closes SF patch 600152.

Rev 1.44 doerwalter
(string methods)

Since it tests both ntohl and ntohs, the test should not be called
testNtoHL but testNtoH.

Merge Py Idle changes
Rev 1.16
(skip. The Edward K. Ream breakpoint fix has been added to bdb.py
and idlefork Debugger.py no longer overrides Bdb.set_break() )

Rev 1.17
Remove unnecessary imports

Merge Py Idle changes
Rev 1.13 (string methods)

Merge Py Idle changes
Rev 1.9
Improve handling of docstrings.  I had feared this was a case of
introspection incompatibility, but in fact it's just that calltips
always gave up on a docstring that started with a newline (but
didn't realize they were giving up <wink>).

Rev 1.10
(already merged)

Rev 1.11
(whitespace normalization, skip this time)

Rev 1.12
Remove unnecessary imports

Merge Py Idle changes
Rev 1.4
SF bug 546078:  IDLE calltips cause application error.
Assorted crashes on Windows and Linux when trying to display a very
long calltip, most likely a Tk bug.  Wormed around by clamping the
calltip display to a maximum of 79 characters (why 79? why not ...).

Bugfix candidate, for all Python releases.

Rev 1.5
Remove unnecessary imports

Merge Py Idle's Rev 1.16 (string methods)

Merge Py Idle's changes to AutoIndent.py into EditorWindow.py since
EditorWindow has incorporated AutoIndent

Rev 1.17
classifyws():  Fix a "/" to work under -Qnew (as well as without it).
Bugfix candidate!

Rev 1.18
(Already merged)

Rev 1.19
smart_backspace_event():  remove now-pointless int() call.
Bugfix candidate:  the current state of AutoIdent.py should be in 2.2.1.

Rev 1.20
Apply diff2.txt from SF patch http://www.python.org/sf/572113
(with one small bugfix in bgen/bgen/scantools.py)
This replaces string module functions with string methods
for the stuff in the Tools directory. Several uses of
string.letters etc. are still remaining.

Merge Py Idle's Rev 1.5
Use string.ascii_letters instead of string.letters (SF bug #226706)

I think it makes more sense that the pseudo filename used by fdopen()
be "<fdopen>" rather than "(fdopen)".

Use Py_GCC_ATTRIBUTE instead of __attribute__.  Compilers other than GCC
might use __attribute__ in other ways (e.g. CodeWarrior).

Address SF bug #577530: del __builtins__ breaks out of rexec

Using the suggestion there: add_module() forces __builtin__ back; this
fixes r_exec, r_eval, r_execfile.  The interactive console had to be
fixed separately, because it doesn't use r_exec, but relies on the
'locals' dict having the right __builtins__.  Fixed this by
subclassing InteractiveConsole and overriding runcode(), which does
the exec.  This changes the banner output slightly: instead of
starting with *** RESTRICTED ***, a subtler (RestrictedConsole) is
printed before the first >>> prompt.

Also import readline (if it exists) when the interactive console is
used, for more convenient input editing and history.

This does not mean that rexec is now considered safe!  But for those
willing to take the risk, it's safer than before.  (Note that a safety
analysis of the code module would be wise if you plan to use the
interactive console for real -- I've only ever used it to play with
restricted mode.)

This should be backported to 2.2 and 2.1.

Initial revision

Don't test whether surrogate sequences round-trip in UTF-8. 2.2.2 candidate.

Use integer above sys.maxunicode for range test. Fixes #608884.
2.2.2 candidate.

Bump to reflect final cleanup of Config system and first pass GRPC
completed

MERGE DS_RPC_BRANCH into MAIN

 Removed Files:
  AutoIndent.py IdleConf.py MultiScrolledLists.py Separator.py
  config-unix.txt config-win.txt config.txt eventparse.py
  keydefs.py

MERGE DS_RPC_BRANCH into MAIN:
config-keys.def
    AutoIndent merged 21Jul

MERGE DS_RPC_BRANCH into MAIN
configHandler.py
    AutoIndent merged 21Jul

MERGE DS_RPC_BRANCH into MAIN:
config-extensions.def
    AutoIndent merged 21Jul

MERGE DS_RPC_BRANCH into MAIN:
configDialog.py
    AutoIndent merged 21Jul

MERGE DS_RPC_BRANCH into MAIN
ToolTip.py
    cleanup 05Aug

MERGE DS_RPC_BRANCH into MAIN
ReplaceDialog
    (missed a change Py Idle 04Apr2002, Booleans, pick up later)
    track Py Idle: GvR drops 1.5.2 re support 24 Jul

MERGE DS_RPC_BRANCH into MAIN
PyShell.py
    don't track Py Idle patch 543222 - disable script bindings in shell
    since it was done differently in MAIN

    Remove "binding comments" 05 Aug 1.13.2.2 to 1.13.2.3

MERGE DS_RPC_BRANCH into MAIN
ParenMatch.py
    Remove last dependencies to old config backend 06Aug

MERGE DS_RPC_BRANCH into MAIN
EditorWindow.py
    don't track Py Idle patch 543222 - disable script bindings in shell
    since it was done differently in MAIN

    Remove "binding comments" 05 Aug 1.23.2.3 to 1.23.2.4
    Remove last dependencies to old config backend 06Aug to 1.23.2.5

MERGE DS_RPC_BRANCH into MAIN
EditorWindow.py
    AutoIndent merged 21Jul
    Comment out debug messages 21Jul

Fix a couple of minor markup glitches.

Maybe this fixes test_socket on 64-bit Linux.

MERGE DS_RPC_BRANCH into MAIN
CallTips
    track Py Idle loewis: Use ascii_letters to avoid UnicodeErrors 06Aug

Bindings.py
    AutoIndent merged 21Jul
    cleanup and remove references to config backend 06Aug

Add two items

Add a bunch of sys.stdout.flush() calls that will hopefully improve
the usability of the output of the Xenofarm builds.

SF # 602108 ensure string is null terminated after strncpy

Fiddle with compact_traceback().

More whitespace cleanup.

Fix part of SF bug # 544248 gcc warning in unicodeobject.c

When --enable-unicode=ucs4, need to cast Py_UNICODE to a char

Shut up FutureWarnings about hex constants.

Patch by Tony Lownds: build an IDLE applet too, if _tkinter is available.
I modified the patch to make it a non-fatal error if IDLE isn't built.

Patch by Tony Lownds: add the Resources directory to sys.path.

Merge from DS_RPC_BRANCH
Modified Files:
  INSTALL.txt

Remove unnecessary imports

Remove unused local variables

Remove unnecessary imports

When testing for localhost/ first map to lower case. Spotted by Skip.

Treat file://localhost/ as local too (same as file:/ and file:///).
Fixes #607789, bugfix candidate.

Mode rU for universal newlines, not rT. Spotted by Guido.

Minor revision to the "\\" patch, including updating the docs a little to
accomodate the fact that they are more general now that they are for the
os.path module and not just posixpath.

This and the previous patch should be combined and applied to the 2.2-maint
branch.

add note about os.path.join and drive letters on Windows.

If PyXML is installed, there is no Node.allnodes, so that portion of
the test should be skipped if that's the case.

Relax a test so it passes either with the standard library or PyXML.
The original expected value is actually wrong, but we'll pick up the
real fix and test when we refresh the xml package from PyXML before
2.3a1.

Fix warnings on 64-bit platforms about casts from pointers to ints.
Two of these were real bugs.

Only build the 'dl' extension when sys.maxint equals 2**31-1.
This module raises "SystemError: module dl requires sizeof(int) ==
sizeof(long) == sizeof(char*)" when compiled on 64-bit platforms.