Thanks to visit codestin.com
Credit goes to github.com

Skip to content

Commit f5934dd

Browse files
committed
Update for Alpha 0 Release
1 parent f970d61 commit f5934dd

2 files changed

Lines changed: 61 additions & 182 deletions

File tree

Lib/idlelib/INSTALL.txt

Lines changed: 26 additions & 45 deletions
Original file line numberDiff line numberDiff line change
@@ -1,58 +1,39 @@
1-
IDLEfork INSTALL notes
2-
======================
1+
IDLEfork Installation Notes
2+
===========================
33

4-
The emphasis in IDLEfork is now for the project to be able to be run
5-
directly from the unpacked source directory. This is to enable easy testing
6-
of (and hacking on) IDLEfork, and will also prevent interfering with the
7-
stable Python IDLE set up in any way.
4+
IDLEfork requires Python Version 2.2 or later.
85

9-
To install IDLEfork just unpack the archive into its own directory wherever
10-
you like. To run IDLEfork just go to the directory you unpacked IDLEfork
11-
into and then run 'python idle.py' in an xterm under unix/linux, or
12-
'idle.pyw' under windows 98/2000. Remember that IDLEfork 0.8.1 and greater
13-
require python 2.1 or greater.
6+
There are several distribution files (where xx is the subversion):
147

15-
See README.txt and NEWS.txt for more details on this version of IDLEfork.
8+
IDLEfork-0.9xx.win32.exe
9+
This is a Windows installer which will install IDLEfork in
10+
..../site-packages/idleforklib/ and place the idefork startup script
11+
at ..../scripts/idlefork. Rename this to idlefork.pyw and
12+
point your launcher icons at it. Installation is as idlefork
13+
to avoid conflict with the original Python IDLE.
1614

15+
IDLEfork-0.9xx-1.noarch.rpm
16+
This is an rpm which is designed to install as idleforklib in the
17+
/usr/lib/python2.2 tree created by the Python2 rpm. It requires
18+
python2 and python2-tkinter rpms. It installs as idlefork to avoid
19+
conflict with Python IDLE.
1720

18-
INSTALLATION notes from IDLE fork 0.7.1 :
19-
=========================================
21+
IDLEfork-0.9xx.tar.gz
22+
This is a distutils sdist (source) tarfile which can be used to make
23+
installations on platforms not supported by the above files.
24+
It is configured to install as IDLE, not IDLEfork.
2025

21-
IDLE Fork Installation on Linux:
26+
Unpack in ..../Tools/, cd to the IDLEfork directory created, and
27+
<python setup.py install> to install as IDLE. If you don't want to
28+
step on Python IDLE, it is also possible to simply run <python idle.py>
29+
to test in the IDLEfork source directory without installation. In this
30+
case, IDLEfork will not be on your PATH unless you are in the source
31+
directory.
2232

23-
Until the tarball is released, you must download a CVS copy. An excellent
24-
place for it is
33+
See README.txt for more details on this version of IDLEfork.
2534

26-
/usr/local/src/PythonX.X/Tools/idlefork, assuming that's where your Python
27-
source is located. Put the correct version in for X.X .
2835

29-
# cd /usr/local/src/PythonX.X/Tools
3036

31-
Now do the CVS login and checkout:
3237

33-
# cvs -d:pserver:[email protected]:/cvsroot/idlefork login
3438

35-
Type an <enter> for the password.
3639

37-
# cvs -z3 -d:pserver:[email protected]:/cvsroot/idlefork \
38-
-d idlefork checkout idle
39-
40-
The -d option to checkout puts the files in an idlefork directory, so you don't
41-
step on "official" idle.
42-
43-
# cd idlefork
44-
# su to root
45-
46-
# python setup.py install
47-
48-
# echo idlelib >> /usr/local/lib/pythonX.X/site-packages/site-packages.pth
49-
50-
This last is necessary so idle can find itself. I hope we can create/append
51-
this file via setup.py at some point, but it needs to be done manually now, and
52-
it only needs to be done once (unless you totally remove and reinstall python
53-
itself). (Replace X.X with the correct version for your Python.)
54-
55-
# exit from root
56-
57-
NOTE that the above procedure will install idlefork IDLE on top of any
58-
"official" IDLE that may be already installed.

Lib/idlelib/README.txt

Lines changed: 35 additions & 137 deletions
Original file line numberDiff line numberDiff line change
@@ -2,157 +2,55 @@ IDLEfork README
22
===============
33

44
IDLEfork is an official experimental fork of Python's Integrated
5-
DeveLopment Environment IDLE. Worthwhile and successful changes and
6-
additions will go back into the Python distribution's IDLE at some
7-
later stage. There is no spanish inquisition.
5+
DeveLopment Environment IDLE. The biggest change is to execute
6+
Python code in a separate process, which is /restarted/ for each
7+
Run (F5) initiated from an editor window. This enhancement of
8+
IDLE has often been requested, and is now finally available,
9+
complete with debugger.
810

9-
As David Scherer aptly put it in the original IDLE fork README (below),
11+
There is also a new GUI configuration manager which makes it easy
12+
to select fonts, colors, and startup options.
13+
14+
IDLEfork will be merged back into the Python distribution in the
15+
near future (probably 2.3), replacing the current version of IDLE.
16+
17+
As David Scherer aptly put it in the original IDLEfork README,
1018
"It is alpha software and might be unstable. If it breaks, you get to
11-
keep both pieces." One of the aims of IDLEfork now is for it to be able
12-
to be uncompressed into its own directory and run from there, that way
13-
you can play with (or hack on) IDLEfork without any further installation,
14-
and entirely separately from your stable python IDLE distribution.
19+
keep both pieces."
1520

16-
If you find bugs or undesired behaviour please code nifty patches and
17-
submit them to the IDLEfork SourceForge patch manager, 8^) or let us
18-
know about it in one of the appropriate fora. See the IDLEfork home
19-
page at
21+
If you find bugs let us know about them by using the IDLEfork Bug
22+
Tracker. See the IDLEfork home page at
2023

21-
http://idlefork.sourceforge.net
24+
http://idlefork.sourceforge.net
2225

23-
for details on the various ways to give input to or contact the project.
26+
for details. Patches are always appreciated at the IDLEfork Patch
27+
Tracker.
2428

2529
Please see the files NEWS.txt and ChangeLog for more up to date
2630
information on changes in this release of IDLEfork.
2731

32+
Thanks for trying IDLEfork.
2833

29-
Thanks for trying IDLEfork,
30-
Stephen M. Gava.
31-
32-
33-
34-
35-
README from IDLE fork 0.7.1 :
36-
=============================
37-
38-
EXPERIMENTAL LOADER IDLE 2000-05-29
39-
-----------------------------------
40-
41-
David Scherer <[email protected]>
42-
43-
This is a modification of the CVS version of IDLE 0.5, updated as of
44-
2000-03-09. It is alpha software and might be unstable. If it breaks,
45-
you get to keep both pieces.
46-
47-
If you have problems or suggestions, you should either contact me or
48-
post to the list at http://www.python.org/mailman/listinfo/idle-dev
49-
(making it clear that you are using this modified version of IDLE).
50-
51-
Changes:
52-
53-
The ExecBinding module, a replacement for ScriptBinding, executes
54-
programs in a separate process, piping standard I/O through an RPC
55-
mechanism to an OnDemandOutputWindow in IDLE. It supports executing
56-
unnamed programs (through a temporary file). It does not yet support
57-
debugging.
58-
59-
When running programs with ExecBinding, tracebacks will be clipped
60-
to exclude system modules. If, however, a system module calls back
61-
into the user program, that part of the traceback will be shown.
62-
63-
The OnDemandOutputWindow class has been improved. In particular,
64-
it now supports a readline() function used to implement user input,
65-
and a scroll_clear() operation which is used to hide the output of
66-
a previous run by scrolling it out of the window.
67-
68-
Startup behavior has been changed. By default IDLE starts up with
69-
just a blank editor window, rather than an interactive window. Opening
70-
a file in such a blank window replaces the (nonexistent) contents of
71-
that window instead of creating another window. Because of the need to
72-
have a well-known port for the ExecBinding protocol, only one copy of
73-
IDLE can be running. Additional invocations use the RPC mechanism to
74-
report their command line arguments to the copy already running.
75-
76-
The menus have been reorganized. In particular, the excessively large
77-
'edit' menu has been split up into 'edit', 'format', and 'run'.
78-
79-
'Python Documentation' now works on Windows, if the win32api module is
80-
present.
81-
82-
A few key bindings have been changed: F1 now loads Python Documentation
83-
instead of the IDLE help; shift-TAB is now a synonym for unindent.
84-
85-
New modules:
86-
ExecBinding.py Executes program through loader
87-
loader.py Bootstraps user program
88-
protocol.py RPC protocol
89-
Remote.py User-process interpreter
90-
spawn.py OS-specific code to start programs
91-
92-
Files modified:
93-
autoindent.py ( bindings tweaked )
94-
bindings.py ( menus reorganized )
95-
config.txt ( execbinding enabled )
96-
editorwindow.py ( new menus, fixed 'Python Documentation' )
97-
filelist.py ( hook for "open in same window" )
98-
formatparagraph.py ( bindings tweaked )
99-
idle.bat ( removed absolute pathname )
100-
idle.pyw ( weird bug due to import with same name? )
101-
iobinding.py ( open in same window, EOL convention )
102-
keydefs.py ( bindings tweaked )
103-
outputwindow.py ( readline, scroll_clear, etc )
104-
pyshell.py ( changed startup behavior )
105-
readme.txt ( <Recursion on file with id=1234567> )
106-
107-
IDLE 0.5 - February 2000
108-
------------------------
109-
110-
This is an early release of IDLE, my own attempt at a Tkinter-based
111-
IDE for Python.
112-
113-
For news about this release, see the file NEWS.txt. (For a more
114-
detailed change log, see the file ChangeLog.)
115-
116-
FEATURES
117-
118-
IDLE has the following features:
119-
120-
- coded in 100% pure Python, using the Tkinter GUI toolkit (i.e. Tcl/Tk)
121-
122-
- cross-platform: works on Windows and Unix (on the Mac, there are
123-
currently problems with Tcl/Tk)
124-
125-
- multi-window text editor with multiple undo, Python colorizing
126-
and many other features, e.g. smart indent and call tips
127-
128-
- Python shell window (a.k.a. interactive interpreter)
129-
130-
- debugger (not complete, but you can set breakpoints, view and step)
131-
132-
USAGE
133-
134-
The main program is in the file "idle.py"; on Unix, you should be able
135-
to run it by typing "./idle.py" to your shell. On Windows, you can
136-
run it by double-clicking it; you can use idle.pyw to avoid popping up
137-
a DOS console. If you want to pass command line arguments on Windows,
138-
use the batch file idle.bat.
13934

140-
Command line arguments: files passed on the command line are executed,
141-
not opened for editing, unless you give the -e command line option.
142-
Try "./idle.py -h" to see other command line options.
35+
IDLEfork 0.9 Alpha 0
36+
--------------------------------
14337

144-
IDLE requires Python 1.5.2, so it is currently only usable with a
145-
Python 1.5.2 distribution. (An older version of IDLE is distributed
146-
with Python 1.5.2; you can drop this version on top of it.)
38+
Introduced the new RPC implementation, which includes a debugger. The
39+
output of user code is to the shell, and the shell may be used to
40+
inspect the environment after the run has finished. (In version 0.8.1
41+
the shell environment was separate from the environment of the user
42+
code.)
14743

148-
COPYRIGHT
44+
Introduced the configuration GUI and a new About dialog.
14945

150-
IDLE is covered by the standard Python copyright notice
151-
(http://www.python.org/doc/Copyright.html).
46+
Adapted to the Mac platform.
15247

153-
FEEDBACK
48+
Multiple bug fixes and usability enhancements.
15449

155-
(removed, since Guido probably doesn't want complaints about my
156-
changes)
50+
Known issues:
15751

158-
--Guido van Rossum (home page: http://www.python.org/~guido/)
52+
- Can't kill a tight loop in the Windows version: Use the Task Manager!
53+
- Printing under Linux may be problematic.
54+
- The debugger is pretty slow.
55+
- RPC stack levels are not being pruned from debugger tracebacks.
56+
- Changelog and NEWS.txt are incomplete.

0 commit comments

Comments
 (0)