-IDLEfork INSTALL notes
-======================
+IDLEfork Installation Notes
+===========================
-The emphasis in IDLEfork is now for the project to be able to be run
-directly from the unpacked source directory. This is to enable easy testing
-of (and hacking on) IDLEfork, and will also prevent interfering with the
-stable Python IDLE set up in any way.
+IDLEfork requires Python Version 2.2 or later.
-To install IDLEfork just unpack the archive into its own directory wherever
-you like. To run IDLEfork just go to the directory you unpacked IDLEfork
-into and then run 'python idle.py' in an xterm under unix/linux, or
-'idle.pyw' under windows 98/2000. Remember that IDLEfork 0.8.1 and greater
-require python 2.1 or greater.
+There are several distribution files (where xx is the subversion):
-See README.txt and NEWS.txt for more details on this version of IDLEfork.
+IDLEfork-0.9xx.win32.exe
+ This is a Windows installer which will install IDLEfork in
+ ..../site-packages/idleforklib/ and place the idefork startup script
+ at ..../scripts/idlefork. Rename this to idlefork.pyw and
+ point your launcher icons at it. Installation is as idlefork
+ to avoid conflict with the original Python IDLE.
+IDLEfork-0.9xx-1.noarch.rpm
+ This is an rpm which is designed to install as idleforklib in the
+ /usr/lib/python2.2 tree created by the Python2 rpm. It requires
+ python2 and python2-tkinter rpms. It installs as idlefork to avoid
+ conflict with Python IDLE.
-INSTALLATION notes from IDLE fork 0.7.1 :
-=========================================
+IDLEfork-0.9xx.tar.gz
+ This is a distutils sdist (source) tarfile which can be used to make
+ installations on platforms not supported by the above files.
+ It is configured to install as IDLE, not IDLEfork.
-IDLE Fork Installation on Linux:
+ Unpack in ..../Tools/, cd to the IDLEfork directory created, and
+ <python setup.py install> to install as IDLE. If you don't want to
+ step on Python IDLE, it is also possible to simply run <python idle.py>
+ to test in the IDLEfork source directory without installation. In this
+ case, IDLEfork will not be on your PATH unless you are in the source
+ directory.
-Until the tarball is released, you must download a CVS copy. An excellent
-place for it is
+See README.txt for more details on this version of IDLEfork.
-/usr/local/src/PythonX.X/Tools/idlefork, assuming that's where your Python
-source is located. Put the correct version in for X.X .
-# cd /usr/local/src/PythonX.X/Tools
-Now do the CVS login and checkout:
-# cvs -d:pserver:anonymous@cvs.idlefork.sourceforge.net:/cvsroot/idlefork login
-Type an <enter> for the password.
-# cvs -z3 -d:pserver:anonymous@cvs.idlefork.sourceforge.net:/cvsroot/idlefork \
- -d idlefork checkout idle
-
-The -d option to checkout puts the files in an idlefork directory, so you don't
-step on "official" idle.
-
-# cd idlefork
-# su to root
-
-# python setup.py install
-
-# echo idlelib >> /usr/local/lib/pythonX.X/site-packages/site-packages.pth
-
-This last is necessary so idle can find itself. I hope we can create/append
-this file via setup.py at some point, but it needs to be done manually now, and
-it only needs to be done once (unless you totally remove and reinstall python
-itself). (Replace X.X with the correct version for your Python.)
-
-# exit from root
-
-NOTE that the above procedure will install idlefork IDLE on top of any
-"official" IDLE that may be already installed.
===============
IDLEfork is an official experimental fork of Python's Integrated
-DeveLopment Environment IDLE. Worthwhile and successful changes and
-additions will go back into the Python distribution's IDLE at some
-later stage. There is no spanish inquisition.
+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.
-As David Scherer aptly put it in the original IDLE fork README (below),
+There is also a new GUI configuration manager which makes it easy
+to select fonts, colors, and startup options.
+
+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." One of the aims of IDLEfork now is for it to be able
-to be uncompressed into its own directory and run from there, that way
-you can play with (or hack on) IDLEfork without any further installation,
-and entirely separately from your stable python IDLE distribution.
+keep both pieces."
-If you find bugs or undesired behaviour please code nifty patches and
-submit them to the IDLEfork SourceForge patch manager, 8^) or let us
-know about it in one of the appropriate fora. See the IDLEfork home
-page at
+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
+http://idlefork.sourceforge.net
-for details on the various ways to give input to or contact the project.
+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.
-Thanks for trying IDLEfork,
-Stephen M. Gava.
-<elguavas@users.sourceforge.net>
-
-
-
-README from IDLE fork 0.7.1 :
-=============================
-
-EXPERIMENTAL LOADER IDLE 2000-05-29
------------------------------------
-
- 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
-IDE for Python.
-
-For news about this release, see the file NEWS.txt. (For a more
-detailed change log, see the file ChangeLog.)
-
-FEATURES
-
-IDLE has the following features:
-
-- coded in 100% pure Python, using the Tkinter GUI toolkit (i.e. Tcl/Tk)
-
-- cross-platform: works on Windows and Unix (on the Mac, there are
-currently problems with Tcl/Tk)
-
-- multi-window text editor with multiple undo, Python colorizing
-and many other features, e.g. smart indent and call tips
-
-- Python shell window (a.k.a. interactive interpreter)
-
-- debugger (not complete, but you can set breakpoints, view and step)
-
-USAGE
-
-The main program is in the file "idle.py"; on Unix, you should be able
-to run it by typing "./idle.py" to your shell. On Windows, you can
-run it by double-clicking it; you can use idle.pyw to avoid popping up
-a DOS console. If you want to pass command line arguments on Windows,
-use the batch file idle.bat.
-Command line arguments: files passed on the command line are executed,
-not opened for editing, unless you give the -e command line option.
-Try "./idle.py -h" to see other command line options.
+IDLEfork 0.9 Alpha 0
+--------------------------------
-IDLE requires Python 1.5.2, so it is currently only usable with a
-Python 1.5.2 distribution. (An older version of IDLE is distributed
-with Python 1.5.2; you can drop this version on top of it.)
+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.)
-COPYRIGHT
+Introduced the configuration GUI and a new About dialog.
-IDLE is covered by the standard Python copyright notice
-(http://www.python.org/doc/Copyright.html).
+Adapted to the Mac platform.
-FEEDBACK
+Multiple bug fixes and usability enhancements.
-(removed, since Guido probably doesn't want complaints about my
-changes)
+Known issues:
---Guido van Rossum (home page: http://www.python.org/~guido/)
+- 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.
projects / python / commitdiff