summaryrefslogtreecommitdiffstats
path: root/Tools
diff options
context:
space:
mode:
Diffstat (limited to 'Tools')
-rw-r--r--Tools/idle/help.txt76
1 files changed, 63 insertions, 13 deletions
diff --git a/Tools/idle/help.txt b/Tools/idle/help.txt
index 80c669f..001da01 100644
--- a/Tools/idle/help.txt
+++ b/Tools/idle/help.txt
@@ -4,7 +4,24 @@ Click on the dotted line at the top of a menu to "tear it off": a
separate window containing the menu is created.
File menu:
- (This should speak for itself.)
+
+ New window -- create a new editing window
+ Open... -- open an existing file
+ Open module... -- open an existing module (searches sys.path)
+ Class browser -- show classes and methods in current file
+ Path browser -- show sys.path directories, modules, classes
+ and methods
+ ---
+ Save -- save current window to the associated file (unsaved
+ windows have a * before and after the window title)
+
+ Save As... -- save current window to new file, which becomes
+ the associated file
+ Save Copy As... -- save current window to different file
+ without changing the associated file
+ ---
+ Close -- close current window (asks to save if unsaved)
+ Exit -- close all windows and quit IDLE (asks to save if unsaved)
Edit menu:
@@ -33,8 +50,8 @@ Edit menu:
word in the same buffer; repeat to get a different expansion
Format Paragraph -- Reformat the current blank-line-separated paragraph
---
- Run module -- Import or reload the current module
- Debug module -- Ditto, under debugger control
+ Import module -- Import or reload the current module
+ Run script -- Execute the current file in the __main__ namespace
Windows menu:
@@ -64,9 +81,12 @@ Basic editing and navigation:
Automatic indentation:
After a block-opening statement, the next line is indented by
- 4 spaces (in the Python Shell window by one tab). In leading
- indentation, Backspace deletes 4 spaces if they are there.
- Also see the indent/dedent region commands.
+ 4 spaces (in the Python Shell window by one tab). After
+ certain keywords (break, return etc.) the next line is
+ dedented. In leading indentation, Backspace deletes up to 4
+ spaces if they are there. Tab inserts 1-4 spaces (in the
+ Python Shell window one tab). See also the indent/dedent
+ region commands in the edit menu.
Python Shell window:
@@ -80,26 +100,56 @@ Python Shell window:
Return while on any previous command retrieves that command
Alt-/ (Expand word) is also useful here
-Python syntax colors: the coloring is applied in the background.
+Syntax colors:
+
+ The coloring is applied in a background "thread", so you may
+ occasionally see uncolorized text. To change the color
+ scheme, edit the ColorPrefs class in IdlePrefs.py.
+
+ Python syntax colors:
Keywords orange
Strings green
Comments red
Definitions blue
-Shell colors:
+ Shell colors:
Console output brown
stdout blue
stderr dark green
stdin black
-Tips:
+Other preferences:
+
To change the font on Windows, open EditorWindow.py and change
- text['font'] = ("verdana", 8)
+ text['font'] = ("lucida console", 8)
to, e.g.,
text['font'] = ("courier new", 10)
- To change the Python syntax colors, edit the tagdefs table in
- ColorDelegator.py; to change the shell colors, edit the tagdefs
- table in PyShell.py.
+ To change keyboard bindings, edit Bindings.py
+
+Command line usage:
+
+ idle.py [-c command] [-d] [-e] [-s] [-t title] [arg] ...
+
+ -c command run this command
+ -d enable debugger
+ -e edit mode; arguments are files to be edited
+ -s run $IDLESTARTUP or $PYTHONSTARTUP first
+ -t title set title of shell window
+
+ If there are arguments:
+
+ If -e is used, arguments are files opened for editing and
+ sys.argv reflects the arguments passed to IDLE itself.
+
+ Otherwise, if -c is used, all arguments are placed in
+ sys.argv[1:...], with sys.argv[0] set to '-c'.
+
+ Otherwise, if neither -e nor -c is used, the first
+ argument is a script which is executed with the remaining
+ arguments in sys.argv[1:...] and sys.argv[0] set to the
+ script name. If the script name is '-', no script is
+ executed but an interactive Python session is started; the
+ arguments are still available in sys.argv.