Commit 36a6bb96 authored by Kurt B. Kaiser's avatar Kurt B. Kaiser

Update documentation.

parent 4d760281
...@@ -11,14 +11,15 @@ Bruce Sherwood has contributed considerable time testing and suggesting ...@@ -11,14 +11,15 @@ Bruce Sherwood has contributed considerable time testing and suggesting
improvements. improvements.
Besides Guido, the main developers who have been active on IDLEfork version 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 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, the new About menu, and Kurt B. Kaiser, who completed the integration of the
and made a number of usability enhancements. RPC and remote debugger, and made a number of usability enhancements.
Other contributors include Tony Lownds (Mac integration), and Chui Tey (RPC, Other contributors include Tony Lownds (Mac integration), Neal Norwitz (code
Debugger) 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 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 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 ...@@ -28,3 +29,5 @@ Please contact the IDLEfork maintainer to have yourself included here if you
are one of those we missed! are one of those we missed!
Contact details at http://idlefork.sourceforge.net Contact details at http://idlefork.sourceforge.net
...@@ -5,84 +5,13 @@ This file contains the release messages for previous IDLE releases. ...@@ -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. As you read on you go back to the dark ages of IDLE's history.
IDLE fork 0.7.1 - 29 May 2000 IDLE 0.5 - February 2000 - Release Notes
----------------------------- ----------------------------------------
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
------------------------
This is an early release of IDLE, my own attempt at a Tkinter-based This is an early release of IDLE, my own attempt at a Tkinter-based
IDE for Python. IDE for Python.
For news about this release, see the file NEWS.txt. (For a more (For a more detailed change log, see the file ChangeLog.)
detailed change log, see the file ChangeLog.)
FEATURES FEATURES
...@@ -120,3 +49,132 @@ COPYRIGHT ...@@ -120,3 +49,132 @@ COPYRIGHT
IDLE is covered by the standard Python copyright notice IDLE is covered by the standard Python copyright notice
(http://www.python.org/doc/Copyright.html). (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.
======================================================================
+++++++++++++
IDLEfork NEWS IDLEfork NEWS
============= +++++++++++++
(For a more detailed change log, see the file ChangeLog.)
---------------------------------------------------------
IDLEfork 0.9 Alpha 0 (31 DEC 2002) What's New in IDLEfork 0.9 Alpha 2?
---------------------------------- ===================================
First Alpha release with GvR RPC and Configuration GUI. *Release date: XX-XXX-2003*
This file will be updated at next Alpha release. Meanwhile, see README.txt. - Uniform capitalization in General tab of ConfigDialog, update the doc string.
- Fix bug in ConfigDialog where SaveAllChangedConfig() was unexpectedly
deleting Additional Help Sources from the user's config file.
IDLEfork 0.8.1 (22 JUL 2001) - Make configHelpSourceEdit OK button the default and bind <Return>
----------------------------
New tarball released as a result of the 'revitalisation' of the IDLEfork
project.
This release requires python 2.1 or better. Compatability with earlier - Fix Tk root pop-ups in configHelpSourceEdit: error dialogs not attached
versions of python (especially ancient ones like 1.5x) is no longer to parents.
a priority in IDLEfork development.
This release is based on a merging of the earlier IDLE fork work with - Use os.startfile() to open both Additional Help and Python Help on the
current cvs IDLE (post IDLE version 0.8), with some minor additional Windows platform. The application associated with the file type will act as
coding by Kurt B. Kaiser and Stephen M. Gava. the viewer. Windows help files (.chm) are now supported via the
Settings/General/Additional Help facility.
This release is basically functional but also contains some known - If Python Help files are installed locally on Linux, use them instead of
breakages, particularly with running things from the shell window. Also accessing python.org.
the debugger is not working, but I believe this was the case with the
previous IDLE fork release (0.7.1) as well.
This release is being made now to mark the point at which IDLEfork is - Make the methods for finding the Python help docs more robust, and make
launching into a new stage of development. them work in the installed configuration, also.
IDLEfork CVS will now be branched to enable further development and - On the Save Before Run dialog, make the OK button the default. One
exploration of the two "execution in a remote process" patches submitted less mouse action!
by David Scherer (David's is currently in IDLEfork) and GvR, while
stabilisation and development of less heavyweight improvements (like
user customisation) can continue on the trunk.
- Add a method: EditorWindow.get_geometry() for future use in implementing
window location persistence.
IDLE fork 0.7.1 (15 AUG 2000) - Removed the "Help/Advice" menu entry. Thanks, David! We'll remember!
-----------------------------
First project tarball released. - Change the "Classic Windows" theme's paste key to be <ctrl-v>.
- Rearrange the Shell menu to put Stack Viewer entries adjacent.
- Add the ability to restart the subprocess interpreter from the shell window;
add an associated menu entry "Shell/Restart". Update help.
- Upon a restart, annotate the shell window with a "restart boundary". Add a
shell window menu "Shell/View Restart" and hotkey to jump to the most recent
restart boundary.
- Change the shell window menu "Debug" to "Shell"; change "Settings" to
"Options".
This was the first release of IDLE fork, which at this stage was a - Remove incorrect comment in setup.py: IDLEfork is now installed as a package.
combination of IDLE 0.5 and the VPython idle fork, with additional
changes coded by David Scherer, Peter Schneider-Kamp and
Nicholas Riley.
- Add INSTALL.txt, HISTORY.txt, NEWS.txt to installed configuration.
original IDLE NEWS.txt : - In installer text, fix reference to Visual Python, should be VPython.
======================== Properly credit David Scherer.
New in IDLE 0.5 (2/15/2000) - Modified idle, idle.py, idle.pyw to improve exception handling.
-------------------------
Tons of stuff, much of it contributed by Tim Peters and Mark Hammond: - Known issues:
- Status bar, displaying current line/column (Moshe Zadka). + Can't kill a tight loop in the Windows version: Insert a
``print "*",`` in an outer loop or use the Task Manager to kill.
+ Printing under Linux may be problematic.
+ The debugger is pretty slow.
+ RPC stack levels are not being pruned from debugger tracebacks.
- 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 What's New in IDLEfork 0.9 Alpha 1?
them correctly (MH) ===================================
- New version of pyclbr.py parses top-level functions and understands *Release date: 31-Dec-2002*
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 - First release of major new functionality. For further details refer to
multi-line statements (TP) Idle-dev and/or the Sourceforge CVS.
- Call tip window pops up when you type the name of a known function - Adapted to the Mac platform.
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) - Overhauled the IDLE startup options and revised the idle -h help message,
which provides details of command line usage.
- New path and class browsers based on a tree widget that looks - Multiple bug fixes and usability enhancements.
familiar to Windows users
- Reworked script running commands to be more intuitive: I/O now - Introduced the new RPC implementation, which includes a debugger. The output
always goes to the *Python Shell* window, and raw_input() works of user code is to the shell, and the shell may be used to inspect the
correctly. You use F5 to import/reload a module: this adds the module environment after the run has finished. (In version 0.8.1 the shell
name to the __main__ namespace. You use Control-F5 to run a script: environment was separate from the environment of the user code.)
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) - Introduced the configuration GUI and a new About dialog.
------------------------
Most important change: a new menu entry "File -> Path browser", shows - Removed David Scherer's Remote Procedure Call code and replaced with Guido
a 4-column hierarchical browser which lets you browse sys.path, van Rossum's. GvR code has support for the IDLE debugger and uses the shell
directories, modules, and classes. Yes, it's a superset of the Class to inspect the environment of code Run from an Edit window. Files removed:
browser menu entry. There's also a new internal module, ExecBinding.py, loader.py, protocol.py, Remote.py, spawn.py
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. What's New in IDLEfork 0.8.1?
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 *Release date: 22-Jul-2001*
menu update itself whenever a window is opened or closed.
- Menu items can now be have a checkbox (when the menu label starts - New tarball released as a result of the 'revitalisation' of the IDLEfork
with "!"); use this for the Debugger and "Auto-open stack viewer" project.
(was: JIT stack viewer) menu items.
- Added a Quit button to the Debugger API. - This release requires python 2.1 or better. Compatability with earlier
versions of python (especially ancient ones like 1.5x) is no longer a
priority in IDLEfork development.
- The current directory is explicitly inserted into sys.path. - This release is based on a merging of the earlier IDLE fork work with current
cvs IDLE (post IDLE version 0.8), with some minor additional coding by Kurt
B. Kaiser and Stephen M. Gava.
- Fix the debugger (when using Python 1.5.2b2) to use canonical - This release is basically functional but also contains some known breakages,
filenames for breakpoints, so these actually work. (There's still a particularly with running things from the shell window. Also the debugger is
lot of work to be done to the management of breakpoints in the not working, but I believe this was the case with the previous IDLE fork
debugger though.) release (0.7.1) as well.
- Closing a window that is still colorizing now actually works. - This release is being made now to mark the point at which IDLEfork is
launching into a new stage of development.
- Allow dragging of the separator between the two list boxes in the - IDLEfork CVS will now be branched to enable further development and
class browser. exploration of the two "execution in a remote process" patches submitted by
David Scherer (David's is currently in IDLEfork) and GvR, while stabilisation
and development of less heavyweight improvements (like user customisation)
can continue on the trunk.
- 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.)
---------------------------------------------------------------------- What's New in IDLE fork 0.7.1?
==============================
New in IDLE 0.2 (1/8/99) *Release date: 15-Aug-2000*
------------------------
- First project tarball released.
- This was the first release of IDLE fork, which at this stage was a
combination of IDLE 0.5 and the VPython idle fork, with additional changes
coded by David Scherer, Peter Schneider-Kamp and Nicholas Riley.
IDLE fork 0.7.1 - 29 May 2000
-----------------------------
Lots of changes; here are the highlights: David Scherer <dscherer@cmu.edu>
General: - 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.
- You can now write and configure your own IDLE extension modules; see - If you have problems or suggestions, you should either contact me or post to
extend.txt. the list at http://www.python.org/mailman/listinfo/idle-dev (making it clear
that you are using this modified version of IDLE).
- Changes:
File menu: - 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.
The command to open the Python shell window is now in the File menu. - 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.
Edit menu: - 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.
New Find dialog with more options; replace dialog; find in files dialog. - The menus have been reorganized. In particular, the excessively large
'edit' menu has been split up into 'edit', 'format', and 'run'.
Commands to tabify or untabify a region. - 'Python Documentation' now works on Windows, if the win32api module is
present.
Command to format a paragraph. - 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:
Debug menu: 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
JIT (Just-In-Time) stack viewer toggle -- if set, the stack viewer - Files modified:
automaticall pops up when you get a traceback.
Windows menu: 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> )
Zoom height -- make the window full height.
--------------------------------------------------------------------
Refer to HISTORY.txt for additional information on earlier releases.
--------------------------------------------------------------------
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.
======================================================================
IDLEfork README IDLEfork README
=============== ===============
IDLEfork is an official experimental fork of Python's Integrated IDLEfork is an official experimental fork of Python's Integrated DeveLopment
DeveLopment Environment IDLE. The biggest change is to execute Environment, IDLE. The biggest change is to execute Python code in a separate
Python code in a separate process, which is /restarted/ for each process, which is /restarted/ for each Run (F5) initiated from an editor
Run (F5) initiated from an editor window. This enhancement of window. This enhancement of IDLE has often been requested, and is now finally
IDLE has often been requested, and is now finally available, available, complete with the IDLE debugger. The magic "reload/import *"
complete with debugger. 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 There is also a new GUI configuration manager which makes it easy to select
to select fonts, colors, and startup options. 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 IDLEfork will be merged back into the Python distribution in the near future
near future (probably 2.3), replacing the current version of IDLE. (probably 2.3), replacing the current version of IDLE.
As David Scherer aptly put it in the original IDLEfork README, For information on this release, refer to NEWS.txt
"It is alpha software and might be unstable. If it breaks, you get to
keep both pieces."
If you find bugs let us know about them by using the IDLEfork Bug As David Scherer aptly put it in the original IDLEfork README, "It is alpha
Tracker. See the IDLEfork home page at software and might be unstable. If it breaks, you get to keep both pieces."
http://idlefork.sourceforge.net If you find bugs let us know about them by using the IDLEfork Bug Tracker. See
the IDLEfork home page at
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.
http://idlefork.sourceforge.net
IDLEfork 0.9 Alpha 0 for details. Patches are always appreciated at the IDLEfork Patch Tracker, and
-------------------------------- Change Requests should be posted to the RFE Tracker at
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.
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! Thanks for trying IDLEfork.
- 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.
Markdown is supported
0%
or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment