Update to reflect current implementation.

This commit is contained in:
Kurt B. Kaiser 2002-12-11 04:42:39 +00:00
parent f06eed08a8
commit 39c7b45964
1 changed files with 76 additions and 78 deletions

View File

@ -1,29 +1,32 @@
[See end for tips.] [See end for ** TIPS ]
Click on the dotted line at the top of a menu to "tear it off": a Click on the dotted line at the top of a menu to "tear it off": a
separate window containing the menu is created. separate window containing the menu is created.
File menu: File Menu:
New window -- create a new editing window New Window -- create a new editing window
Open... -- open an existing file Open... -- open an existing file
Open module... -- open an existing module (searches sys.path) Recent Files... -- open a list of recent files
Class browser -- show classes and methods in current file Open Module... -- open an existing module (searches sys.path)
Path browser -- show sys.path directories, modules, classes Class Browser -- show classes and methods in current file
and methods Path Browser -- show sys.path directories, modules, classes
and methods
--- ---
Save -- save current window to the associated file (unsaved Save -- save current window to the associated file (unsaved
windows have a * before and after the window title) windows have a * before and after the window title)
Save As... -- save current window to new file, which becomes Save As... -- save current window to new file, which becomes
the associated file the associated file
Save Copy As... -- save current window to different file Save Copy As... -- save current window to different file
without changing the associated file without changing the associated file
---
Print Window -- print the current window
--- ---
Close -- close current window (asks to save if unsaved) Close -- close current window (asks to save if unsaved)
Exit -- close all windows and quit IDLE (asks to save if unsaved) Exit -- close all windows and quit IDLE (asks to save if unsaved)
Edit menu: Edit Menu:
Undo -- Undo last change to current window (max 1000 changes) Undo -- Undo last change to current window (max 1000 changes)
Redo -- Redo last undone change to current window Redo -- Redo last undone change to current window
@ -34,41 +37,70 @@ Edit menu:
Select All -- Select the entire contents of the edit buffer Select All -- Select the entire contents of the edit buffer
--- ---
Find... -- Open a search dialog box with many options Find... -- Open a search dialog box with many options
Find again -- Repeat last search Find Again -- Repeat last search
Find selection -- Search for the string in the selection Find Selection -- Search for the string in the selection
Find in Files... -- Open a search dialog box for searching files Find in Files... -- Open a search dialog box for searching files
Replace... -- Open a search-and-replace dialog box Replace... -- Open a search-and-replace dialog box
Go to line -- Ask for a line number and show that line Go to Line -- Ask for a line number and show that line
--- Expand Word -- Expand the word you have typed to match another
Indent region -- Shift selected lines right 4 spaces word in the same buffer; repeat to get a different
Dedent region -- Shift selected lines left 4 spaces expansion
Comment out region -- Insert ## in front of selected lines
Uncomment region -- Remove leading # or ## from selected lines Format Menu (only in Edit window):
Tabify region -- Turns *leading* stretches of spaces into tabs
Untabify region -- Turn *all* tabs into the right number of spaces Indent Region -- Shift selected lines right 4 spaces
Expand word -- Expand the word you have typed to match another Dedent Region -- Shift selected lines left 4 spaces
word in the same buffer; repeat to get a different expansion Comment Out Region -- Insert ## in front of selected lines
Uncomment Region -- Remove leading # or ## from selected lines
Tabify Region -- Turns *leading* stretches of spaces into tabs
Untabify Region -- Turn *all* tabs into the right number of spaces
New Indent Width... -- Open dialog to change indent width
Format Paragraph -- Reformat the current blank-line-separated paragraph Format Paragraph -- Reformat the current blank-line-separated paragraph
Run Menu (only in Edit window):
Python Shell -- Open or wake up the Python shell window
--- ---
Import module -- Import or reload the current module Check Module -- Run a syntax check on the module
Run script -- Execute the current file in the __main__ namespace Run Script -- Execute the current file in the __main__ namespace
Windows menu: Settings Menu:
Zoom Height -- toggles the window between normal size (24x80) Configure IDLE -- Open a configuration dialog. Fonts, indentation,
keybindings, and color themes may be altered.
Startup preferences may be set.
---
Revert to Default Settings -- Restore original settings
Windows Menu:
Zoom Height -- toggles the window between configured size
and maximum height. and maximum height.
--- ---
The rest of this menu lists the names of all open windows; The rest of this menu lists the names of all open windows;
select one to bring it to the foreground (deiconifying it if select one to bring it to the foreground (deiconifying it if
necessary). necessary).
Debug menu (in the Python Shell window only): Debug Menu (in the Python Shell window only):
Go to file/line -- look around the insert point for a filename Go to File/Line -- look around the insert point for a filename
and linenumber, open the file, and show the line and linenumber, open the file, and show the line
Open stack viewer -- show the stack traceback of the last exception Stack Viewer -- show the stack traceback of the last exception
Debugger toggle -- Run commands in the shell under the debugger Debugger (toggle) -- Run commands in the shell under the debugger
JIT Stack viewer toggle -- Open stack viewer on traceback Auto-open Stack Viewer (toggle) -- Open stack viewer on traceback
Help Menu:
IDLE Help -- Display this file
Python Documentation -- Access local Python documentation, if
installed. Otherwise access python.org.
Advice -- Emergency Only!
IDLE Readme -- Background discussion and change details
---
About IDLE --- Version, copyright, license, credits
** TIPS
========
Basic editing and navigation: Basic editing and navigation:
@ -76,7 +108,8 @@ Basic editing and navigation:
Arrow keys and Page Up/Down to move around Arrow keys and Page Up/Down to move around
Home/End go to begin/end of line Home/End go to begin/end of line
Control-Home/End go to begin/end of file Control-Home/End go to begin/end of file
Some Emacs bindings may also work, e.g. ^B/^P/^A/^E/^D/^L Some Emacs or standard Windows bindings may work.
Keybindings are selected in the Settings Dialog, look there.
Automatic indentation: Automatic indentation:
@ -84,9 +117,9 @@ Automatic indentation:
4 spaces (in the Python Shell window by one tab). After 4 spaces (in the Python Shell window by one tab). After
certain keywords (break, return etc.) the next line is certain keywords (break, return etc.) the next line is
dedented. In leading indentation, Backspace deletes up to 4 dedented. In leading indentation, Backspace deletes up to 4
spaces if they are there. Tab inserts 1-4 spaces (in the spaces if they are there. Tab inserts spaces (in the
Python Shell window one tab). See also the indent/dedent Python Shell window one tab), number depends on Indent Width
region commands in the edit menu. See also the indent/dedent region commands in the edit menu.
Python Shell window: Python Shell window:
@ -104,17 +137,16 @@ Syntax colors:
The coloring is applied in a background "thread", so you may The coloring is applied in a background "thread", so you may
occasionally see uncolorized text. To change the color occasionally see uncolorized text. To change the color
scheme, edit the [Colors] section in config.txt (or add a scheme, use the Settings/Highlighting dialog.
[Colors] section to ~/.idle).
Python syntax colors: Python default syntax colors:
Keywords orange Keywords orange
Strings green Strings green
Comments red Comments red
Definitions blue Definitions blue
Shell colors: Shell default colors:
Console output brown Console output brown
stdout blue stdout blue
@ -123,43 +155,9 @@ Syntax colors:
Other preferences: Other preferences:
To change the font open config-[win/unix/mac].txt and The font preferences, keybinding, and startup preferences can
change be changed using the Settings dialog.
font-name: courier new
font-size: 10
to, for example:
font-name: courier new bold
font-size: 14
Note: a GUI based configuration screen will be provided
in the future.
To change keyboard bindings, edit Bindings.py
Command line usage: Command line usage:
idle.py [-c command] [-d] [-e] [-s] [-t title] [arg] ... Enter idle -h at the command prompt to get a usage message.
-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.