Index: Doc/library/idle.rst =================================================================== --- Doc/library/idle.rst (revision 86309) +++ Doc/library/idle.rst (working copy) @@ -33,53 +33,62 @@ File menu ^^^^^^^^^ -New window - create a new editing window +New Window + Create a new editing window Open... - open an existing file + 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 and methods +Class Browser + Show classes and methods in current file +Path Browser + Show sys.path directories, modules, classes and methods + .. index:: - single: Class browser - single: Path browser + single: Class Browser + single: Path Browser Save - save current window to the associated file (unsaved windows have a \* before and - after the window title) + 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 current window to new file, which becomes the associated file Save Copy As... - save current window to different file without changing the associated file + Save current window to different file without changing the + associated file +Print Window + Print the current window + Close - close current window (asks to save if unsaved) + Close current window (asks to save if unsaved) Exit - close all windows and quit IDLE (asks to save if unsaved) + Close all windows and quit IDLE (asks to save if unsaved) Edit menu ^^^^^^^^^ Undo - Undo last change to current window (max 1000 changes) + Undo last change to current window (A maximum of 1000 changes may + be undone) Redo Redo last undone change to current window Cut - Copy selection into system-wide clipboard; then delete selection + Copy selection into system-wide clipboard, then delete the + selection Copy Copy selection into system-wide clipboard @@ -93,10 +102,10 @@ Find... Open a search dialog box with many options -Find again +Find Again Repeat last search -Find selection +Find Selection Search for the string in the selection Find in Files... @@ -105,75 +114,134 @@ Replace... Open a search-and-replace dialog box -Go to line +Go to Line Ask for a line number and show that line -Indent region - Shift selected lines right 4 spaces +Show call tip + After an unclosed parenthesis for a function, open a small window + with parameter hints -Dedent region - Shift selected lines left 4 spaces +Show Completions + Open a scroll window allowing selection keywords and + attributes -Comment out region +Show surrounding parens + Highlight the surrounding parentheses + +Expand Word + Expand the word you have typed to match another word in the same + buffer; repeat to get a different expansion + +Format Menu (only in Edit window) +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ + +Indent Region + Shift selected lines right by the indent width + +Dedent Region + Shift selected lines left by the indent width + +Comment Out Region Insert ## in front of selected lines -Uncomment region +Uncomment Region Remove leading # or ## from selected lines -Tabify region - Turns *leading* stretches of spaces into tabs +Tabify Region + Turn *leading* stretches of spaces into tabs. (Note: We recommend + using 4 space blocks to indent Python code.) -Untabify region +Untabify Region Turn *all* tabs into the right number of spaces -Expand word - Expand the word you have typed to match another word in the same buffer; repeat - to get a different expansion +Toggle Tabs + Open a dialog to switch between indenting with spaces and tabs +New Indent Width + Open dialog to change indent width + Format Paragraph Reformat the current blank-line-separated paragraph -Import module - Import or reload the current module +Run Menu (only in Edit window) +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ -Run script +Python Shell + Open or wake up the Python shell window + +Check Module + Run a syntax check on the module + +Run Module Execute the current file in the __main__ namespace +Shell Menu (only in Shell window) +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ + +View Last Restart + Scroll the shell window to the last restart + +Restart Shell + Restart the interpreter with a fresh environment + +Debug Menu (only in Shell window) +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ + +Go to File/Line + Look around the insert point for a filename and line number, open + the file, and show the line + +Debugger + Toggle running commands in the shell under the debugger + +Stack Viewer + Show the stack traceback of the last exception + +Auto-open Stack Viewer + Toggle automatically opening the stack viewer on a traceback + .. index:: - single: Import module - single: Run script + single: Stack Viewer + single: Debugger - -Windows menu +Options Menu ^^^^^^^^^^^^ -Zoom Height - toggles the window between normal size (24x80) and maximum height. +Configure Idle... + Open a configuration dialog. Fonts, indentation, keybindings, and + color themes may be altered. Startup preferences may be set, and + Additional Help Sources can be specified -The rest of this menu lists the names of all open windows; select one to bring -it to the foreground (deiconifying it if necessary). + On MacOS X this menu is not present. Use menu 'IDLE -> + Preferences...' instead +Code Context (in Edit window only) + Open a pane at the top of the Edit window which shows the block + context of the section of code which is scrolling off the top or + the window -Debug menu (in the Python Shell window only) -^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ +Windows Menu +^^^^^^^^^^^^ -Go to file/line - look around the insert point for a filename and linenumber, open the file, and - show the line. +Zoom Height + Toggle the window between configured size and maximum height -Open stack viewer - show the stack traceback of the last exception +The rest of this menu lists the names of all open windows; select one +to bring it to the foreground (deiconifying it if necessary). -Debugger toggle - Run commands in the shell under the debugger +Help Menu +^^^^^^^^^ -JIT Stack viewer toggle - Open stack viewer on traceback +About IDLE + Version, copyright, license, credits -.. index:: - single: stack viewer - single: debugger +IDLE Help + Display a help file detailing the menu options, basic editing and + navigation, and other tips. +Python Docs + Access local Python documentation, if installed. Otherwise, access + www.python.org. Basic editing and navigation ---------------------------- Index: Lib/idlelib/help.txt =================================================================== --- Lib/idlelib/help.txt (revision 86309) +++ Lib/idlelib/help.txt (working copy) @@ -15,7 +15,6 @@ --- 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 @@ -24,7 +23,7 @@ Print Window -- Print the current window --- Close -- Close current window (asks to save if unsaved) - Exit -- Close all windows, quit (asks to save if unsaved) + Exit -- Close all windows and quit IDLE (asks to save if unsaved) Edit Menu: @@ -32,7 +31,7 @@ (A maximum of 1000 changes may be undone) Redo -- Redo last undone change to current window --- - Cut -- Copy a selection into system-wide clipboard, + Cut -- Copy selection into system-wide clipboard, then delete the selection Copy -- Copy selection into system-wide clipboard Paste -- Insert system-wide clipboard into window @@ -44,23 +43,26 @@ Find in Files... -- Open a search dialog box for searching files Replace... -- Open a search-and-replace dialog box Go to Line -- Ask for a line number and show that line - Show Calltip -- Open a small window with function param hints + Show call tip -- After an unclosed parenthesis for a function, + open a small window with parameter hints Show Completions -- Open a scroll window allowing selection keywords and attributes. (see '*TIPS*', below) - Show Parens -- Highlight the surrounding parenthesis + Show surrounding parens -- Highlight the surrounding parentheses Expand Word -- Expand the word you have typed to match another word in the same buffer; repeat to get a different expansion Format Menu (only in Edit window): - Indent Region -- Shift selected lines right 4 spaces - Dedent Region -- Shift selected lines left 4 spaces + Indent Region -- Shift selected lines right by the indent width + Dedent Region -- Shift selected lines left by the indent width 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 + Tabify Region -- Turn *leading* stretches of spaces into tabs (Note: We recommend using 4 space blocks to indent Python code.) Untabify Region -- Turn *all* tabs into the right number of spaces + Toggle Tabs -- Open a dialog to switch between indenting with + spaces and tabs New Indent Width... -- Open dialog to change indent width Format Paragraph -- Reformat the current blank-line-separated paragraph @@ -79,30 +81,32 @@ Debug Menu (only in Shell window): - Go to File/Line -- look around the insert point for a filename - and linenumber, open the file, and show the line - Debugger (toggle) -- Run commands in the shell under the debugger + Go to File/Line -- Look around the insert point for a filename + and line number, open the file, and show the line + Debugger -- Toggle running commands in the shell under the + debugger Stack Viewer -- Show the stack traceback of the last exception - Auto-open Stack Viewer (toggle) -- Open stack viewer on traceback + Auto-open Stack Viewer -- Toggle automatically opening the stack + viewer on a traceback Options Menu: Configure IDLE -- Open a configuration dialog. Fonts, indentation, keybindings, and color themes may be altered. Startup Preferences may be set, and Additional Help - Sources can be specified. - + Sources can be specified + On MacOS X this menu is not present, use - menu 'IDLE -> Preferences...' instead. + menu 'IDLE -> Preferences...' instead --- - Code Context -- Open a pane at the top of the edit window which + Code Context -- Open a pane at the top of the edit window which shows the block context of the section of code which is scrolling off the top or the window. - (Not present in Shell window.) + (in Edit window only) Windows Menu: - Zoom Height -- toggles the window between configured size + Zoom Height -- Toggle the window between configured size and maximum height. --- The rest of this menu lists the names of all open windows; @@ -112,7 +116,6 @@ Help Menu: About IDLE -- Version, copyright, license, credits - IDLE Readme -- Background discussion and change details --- IDLE Help -- Display this file Python Docs -- Access local Python documentation, if