Tools/idle/help.txt

   1 [See end for tips.]
   2
   3 Click on the dotted line at the top of a menu to "tear it off": a
   4 separate window containing the menu is created.
   5
   6 File menu:
   7         (This should speak for itself.)
   8
   9 Edit menu:
  10
  11         Undo -- Undo last change to current window (max 1000 changes)
  12         Redo -- Redo last undone change to current window
  13         ---
  14         Cut -- Copy selection into system-wide clipboard; then delete selection
  15         Copy -- Copy selection into system-wide clipboard
  16         Paste -- Insert system-wide clipboard into window
  17         Select All -- Select the entire contents of the edit buffer
  18         ---
  19         Find... -- Open a search dialog box with many options
  20         Find again -- Repeat last search
  21         Find selection -- Search for the string in the selection
  22         Find in Files... -- Open a search dialog box for searching files
  23         Replace... -- Open a search-and-replace dialog box
  24         Go to line -- Ask for a line number and show that line
  25         ---
  26         Indent region -- Shift selected lines right 4 spaces
  27         Dedent region -- Shift selected lines left 4 spaces
  28         Comment out region -- Insert ## in front of selected lines
  29         Uncomment region -- Remove leading # or ## from selected lines
  30         Tabify region -- Turns *leading* stretches of spaces into tabs
  31         Untabify region -- Turn *all* tabs into the right number of spaces
  32         Expand word -- Expand the word you have typed to match another
  33                 word in the same buffer; repeat to get a different expansion
  34         Format Paragraph -- Reformat the current blank-line-separated paragraph
  35         ---
  36         Run module -- Import or reload the current module
  37         Debug module -- Ditto, under debugger control
  38
  39 Windows menu:
  40
  41         Zoom Height -- toggles the window between normal size (24x80)
  42         and maximum height.
  43         ---
  44         The rest of this menu lists the names of all open windows;
  45         select one to bring it to the foreground (deiconifying it if
  46         necessary).
  47
  48 Debug menu (in the Python Shell window only):
  49
  50         Go to file/line -- look around the insert point for a filename
  51                 and linenumber, open the file, and show the line
  52         Open stack viewer -- show the stack traceback of the last exception
  53         Debugger toggle -- Run commands in the shell under the debugger
  54         JIT Stack viewer toggle -- Open stack viewer on traceback
  55
  56 Basic editing and navigation:
  57
  58         Backspace deletes to the left; DEL deletes to the right
  59         Arrow keys and Page Up/Down to move around
  60         Home/End go to begin/end of line
  61         Control-Home/End go to begin/end of file
  62         Some Emacs bindings may also work, e.g. ^B/^P/^A/^E/^D/^L
  63
  64 Automatic indentation:
  65
  66         After a block-opening statement, the next line is indented by
  67         4 spaces (in the Python Shell window by one tab).  In leading
  68         indentation, Backspace deletes 4 spaces if they are there.
  69         Also see the indent/dedent region commands.
  70
  71 Python Shell window:
  72
  73         ^C interrupts executing command
  74         ^D sends end-of-file; closes window if typed at >>> prompt
  75
  76     Command history:
  77
  78         Alt-p retrieves previous command matching what you have typed
  79         Alt-n retrieves next
  80         Return while on any previous command retrieves that command
  81         Alt-/ (Expand word) is also useful here
  82
  83 Python syntax colors: the coloring is applied in the background.
  84
  85         Keywords        orange
  86         Strings         green
  87         Comments        red
  88         Definitions     blue
  89
  90 Shell colors:
  91
  92         Console output  brown
  93         stdout          blue
  94         stderr          dark green
  95         stdin           black
  96
  97 Tips:
  98         To change the font on Windows, open EditorWindow.py and change
  99             text['font'] = ("verdana", 8)
 100         to, e.g.,
 101             text['font'] = ("courier new", 10)
 102
 103         To change the Python syntax colors, edit the tagdefs table in
 104         ColorDelegator.py; to change the shell colors, edit the tagdefs
 105         table in PyShell.py.