Update documentation.

Lib/idlelib/CREDITS.txt

@@ -11,14 +11,15 @@ Bruce Sherwood has contributed considerable time testing and suggesting
 improvements.
 
 Besides Guido, the main developers who have been active on IDLEfork version
-0.8.1 and later are Stephen M. Gava, who implemented the configuration GUI, and
-Kurt B. Kaiser, who continued the integration of the RPC and remote debugger,
-and made a number of usability enhancements.
+0.8.1 and later are Stephen M. Gava, who implemented the Configuration GUI and
+the new About menu, and Kurt B. Kaiser, who completed the integration of the
+RPC and remote debugger, and made a number of usability enhancements.
 
-Other contributors include Tony Lownds (Mac integration), and Chui Tey (RPC,
-Debugger) 
+Other contributors include Tony Lownds (Mac integration), Neal Norwitz (code
+check and clean-up), and Chui Tey (RPC integration, debugger integration and
+persistent breakpoints).
 
-Neal Norwitz and Josh Robb have submitted useful patches. 
+Josh Robb has submitted useful patches. 
 
 There are others who should be included here, especially those who contributed
 to IDLE versions prior to 0.8, principally Mark Hammond, Tim Peters, and Moshe
@@ -28,3 +29,5 @@ Please contact the IDLEfork maintainer to have yourself included here if you
 are one of those we missed! 
 
 Contact details at http://idlefork.sourceforge.net
+
+

Lib/idlelib/HISTORY.txt

@@ -5,84 +5,13 @@ This file contains the release messages for previous IDLE releases.
 As you read on you go back to the dark ages of IDLE's history.
 
 
-IDLE fork 0.7.1 - 29 May 2000
------------------------------
-
-   David Scherer  <dscherer@cmu.edu>
-
-This is a modification of the CVS version of IDLE 0.5, updated as of
-2000-03-09.  It is alpha software and might be unstable.  If it breaks,
-you get to keep both pieces.
-
-If you have problems or suggestions, you should either contact me or
-post to the list at http://www.python.org/mailman/listinfo/idle-dev
-(making it clear that you are using this modified version of IDLE).
-
-Changes:
-
-  The ExecBinding module, a replacement for ScriptBinding, executes
-  programs in a separate process, piping standard I/O through an RPC
-  mechanism to an OnDemandOutputWindow in IDLE.  It supports executing
-  unnamed programs (through a temporary file).  It does not yet support
-  debugging.
-
-  When running programs with ExecBinding, tracebacks will be clipped
-  to exclude system modules.  If, however, a system module calls back
-  into the user program, that part of the traceback will be shown.
-
-  The OnDemandOutputWindow class has been improved.  In particular,
-  it now supports a readline() function used to implement user input,
-  and a scroll_clear() operation which is used to hide the output of
-  a previous run by scrolling it out of the window.
-
-  Startup behavior has been changed.  By default IDLE starts up with
-  just a blank editor window, rather than an interactive window.  Opening
-  a file in such a blank window replaces the (nonexistent) contents of
-  that window instead of creating another window.  Because of the need to
-  have a well-known port for the ExecBinding protocol, only one copy of
-  IDLE can be running.  Additional invocations use the RPC mechanism to
-  report their command line arguments to the copy already running.
-
-  The menus have been reorganized.  In particular, the excessively large
-  'edit' menu has been split up into 'edit', 'format', and 'run'.
-
-  'Python Documentation' now works on Windows, if the win32api module is
-  present.
-
-  A few key bindings have been changed: F1 now loads Python Documentation
-  instead of the IDLE help; shift-TAB is now a synonym for unindent.
-
-New modules:
-  ExecBinding.py         Executes program through loader
-  loader.py              Bootstraps user program
-  protocol.py            RPC protocol
-  Remote.py              User-process interpreter
-  spawn.py               OS-specific code to start programs
-
-Files modified:
-  autoindent.py          ( bindings tweaked )
-  bindings.py            ( menus reorganized )
-  config.txt             ( execbinding enabled )
-  editorwindow.py        ( new menus, fixed 'Python Documentation' )
-  filelist.py            ( hook for "open in same window" )
-  formatparagraph.py     ( bindings tweaked )
-  idle.bat               ( removed absolute pathname )
-  idle.pyw               ( weird bug due to import with same name? )
-  iobinding.py           ( open in same window, EOL convention )
-  keydefs.py             ( bindings tweaked )
-  outputwindow.py        ( readline, scroll_clear, etc )
-  pyshell.py             ( changed startup behavior )
-  readme.txt             ( <Recursion on file with id=1234567> )
-
-
-IDLE 0.5 - February 2000
-------------------------
+IDLE 0.5 - February 2000 - Release Notes
+----------------------------------------
 
 This is an early release of IDLE, my own attempt at a Tkinter-based
 IDE for Python.
 
-For news about this release, see the file NEWS.txt.  (For a more
-detailed change log, see the file ChangeLog.)
+(For a more detailed change log, see the file ChangeLog.)
 
 FEATURES
 
@@ -120,3 +49,132 @@ COPYRIGHT
 
 IDLE is covered by the standard Python copyright notice
 (http://www.python.org/doc/Copyright.html).
+
+
+New in IDLE 0.5 (2/15/2000)
+---------------------------
+
+Tons of stuff, much of it contributed by Tim Peters and Mark Hammond:
+
+- Status bar, displaying current line/column (Moshe Zadka).
+
+- Better stack viewer, using tree widget.  (XXX Only used by Stack
+Viewer menu, not by the debugger.)
+
+- Format paragraph now recognizes Python block comments and reformats
+them correctly (MH)
+
+- New version of pyclbr.py parses top-level functions and understands
+much more of Python's syntax; this is reflected in the class and path
+browsers (TP)
+
+- Much better auto-indent; knows how to indent the insides of
+multi-line statements (TP)
+
+- Call tip window pops up when you type the name of a known function
+followed by an open parenthesis.  Hit ESC or click elsewhere in the
+window to close the tip window (MH)
+
+- Comment out region now inserts ## to make it stand out more (TP)
+
+- New path and class browsers based on a tree widget that looks
+familiar to Windows users
+
+- Reworked script running commands to be more intuitive: I/O now
+always goes to the *Python Shell* window, and raw_input() works
+correctly.  You use F5 to import/reload a module: this adds the module
+name to the __main__ namespace.  You use Control-F5 to run a script:
+this runs the script *in* the __main__ namespace.  The latter also
+sets sys.argv[] to the script name
+
+
+New in IDLE 0.4 (4/7/99)
+------------------------
+
+Most important change: a new menu entry "File -> Path browser", shows
+a 4-column hierarchical browser which lets you browse sys.path,
+directories, modules, and classes.  Yes, it's a superset of the Class
+browser menu entry.  There's also a new internal module,
+MultiScrolledLists.py, which provides the framework for this dialog.
+
+
+New in IDLE 0.3 (2/17/99)
+-------------------------
+
+Most important changes:
+
+- Enabled support for running a module, with or without the debugger.
+Output goes to a new window.  Pressing F5 in a module is effectively a
+reload of that module; Control-F5 loads it under the debugger.
+
+- Re-enable tearing off the Windows menu, and make a torn-off Windows
+menu update itself whenever a window is opened or closed.
+
+- Menu items can now be have a checkbox (when the menu label starts
+with "!"); use this for the Debugger and "Auto-open stack viewer"
+(was: JIT stack viewer) menu items.
+
+- Added a Quit button to the Debugger API.
+
+- The current directory is explicitly inserted into sys.path.
+
+- Fix the debugger (when using Python 1.5.2b2) to use canonical
+filenames for breakpoints, so these actually work.  (There's still a
+lot of work to be done to the management of breakpoints in the
+debugger though.)
+
+- Closing a window that is still colorizing now actually works.
+
+- Allow dragging of the separator between the two list boxes in the
+class browser.
+
+- Bind ESC to "close window" of the debugger, stack viewer and class
+browser.  It removes the selection highlighting in regular text
+windows.  (These are standard Windows conventions.)
+
+
+New in IDLE 0.2 (1/8/99)
+------------------------
+
+Lots of changes; here are the highlights:
+
+General:
+
+- You can now write and configure your own IDLE extension modules; see
+extend.txt.
+
+
+File menu:
+
+The command to open the Python shell window is now in the File menu.
+
+
+Edit menu:
+
+New Find dialog with more options; replace dialog; find in files dialog.
+
+Commands to tabify or untabify a region.
+
+Command to format a paragraph.
+
+
+Debug menu:
+
+JIT (Just-In-Time) stack viewer toggle -- if set, the stack viewer
+automaticall pops up when you get a traceback.
+
+Windows menu:
+
+Zoom height -- make the window full height.
+
+
+Help menu:
+
+The help text now show up in a regular window so you can search and
+even edit it if you like.
+
+
+
+IDLE 0.1 was distributed with the Python 1.5.2b1 release on 12/22/98.
+
+======================================================================

Lib/idlelib/README.txt

 IDLEfork README
 ===============
 
-IDLEfork is an official experimental fork of Python's Integrated 
-DeveLopment Environment IDLE.  The biggest change is to execute
-Python code in a separate process, which is /restarted/ for each
-Run (F5) initiated from an editor window.  This enhancement of
-IDLE has often been requested, and is now finally available,
-complete with debugger. 
+IDLEfork is an official experimental fork of Python's Integrated DeveLopment
+Environment, IDLE.  The biggest change is to execute Python code in a separate
+process, which is /restarted/ for each Run (F5) initiated from an editor
+window.  This enhancement of IDLE has often been requested, and is now finally
+available, complete with the IDLE debugger.  The magic "reload/import *"
+incantations are no longer required when editing/testing a module two or three
+steps down the import chain.
 
-There is also a new GUI configuration manager which makes it easy
-to select fonts, colors, and startup options.
+There is also a new GUI configuration manager which makes it easy to select
+fonts, colors, keybindings, and startup options.  There is new feature where
+the user can specify additional help sources, either locally or on the web.
 
-IDLEfork will be merged back into the Python distribution in the
-near future (probably 2.3), replacing the current version of IDLE.
+IDLEfork will be merged back into the Python distribution in the near future
+(probably 2.3), replacing the current version of IDLE.
 
-As David Scherer aptly put it in the original IDLEfork README,
-"It is alpha software and might be unstable. If it breaks, you get to 
-keep both pieces." 
+For information on this release, refer to NEWS.txt
 
-If you find bugs let us know about them by using the IDLEfork Bug
-Tracker.  See the IDLEfork home page at
+As David Scherer aptly put it in the original IDLEfork README, "It is alpha
+software and might be unstable. If it breaks, you get to keep both pieces."
 
-http://idlefork.sourceforge.net 
-
-for details.  Patches are always appreciated at the IDLEfork Patch
-Tracker.
-
-Please see the files NEWS.txt and ChangeLog for more up to date
-information on changes in this release of IDLEfork.
-
-Thanks for trying IDLEfork.
+If you find bugs let us know about them by using the IDLEfork Bug Tracker.  See
+the IDLEfork home page at
 
+http://idlefork.sourceforge.net 
 
-IDLEfork 0.9 Alpha 0
---------------------------------
-
-Introduced the new RPC implementation, which includes a debugger.  The
-output of user code is to the shell, and the shell may be used to
-inspect the environment after the run has finished.  (In version 0.8.1
-the shell environment was separate from the environment of the user
-code.)
-
-Introduced the configuration GUI and a new About dialog.
+for details.  Patches are always appreciated at the IDLEfork Patch Tracker, and
+Change Requests should be posted to the RFE Tracker at
 
-Adapted to the Mac platform.
+https://sourceforge.net/tracker/?group_id=9579&atid=359579  
 
-Multiple bug fixes and usability enhancements.
+There is a mail list for IDLE: idle-dev@python.org.  You can join at
 
-Known issues:
+http://mail.python.org/mailman/listinfo/idle-dev
 
-- Can't kill a tight loop in the Windows version: Use the Task Manager!
-- Printing under Linux may be problematic.
-- The debugger is pretty slow.
-- RPC stack levels are not being pruned from debugger tracebacks.
-- Changelog and NEWS.txt are incomplete.
+Thanks for trying IDLEfork.