From ea9c8bd44365ae8b0accc5286c7b52862528c0ec Mon Sep 17 00:00:00 2001 From: Terry Jan Reedy Date: Sun, 28 Oct 2018 20:42:18 -0400 Subject: bpo-35097: Add IDLE doc subsection explaining editor windows. (#10206) Topics include opening, title and status bar, .py* extension, and running. --- Doc/library/idle.rst | 19 ++++++++++++++++++- Lib/idlelib/help.html | 17 +++++++++++++++++ .../IDLE/2018-10-28-20-17-14.bpo-35097.07tm66.rst | 2 ++ 3 files changed, 37 insertions(+), 1 deletion(-) create mode 100644 Misc/NEWS.d/next/IDLE/2018-10-28-20-17-14.bpo-35097.07tm66.rst diff --git a/Doc/library/idle.rst b/Doc/library/idle.rst index 22a82e1..645bd61 100644 --- a/Doc/library/idle.rst +++ b/Doc/library/idle.rst @@ -358,6 +358,24 @@ Squeeze Editing and navigation ---------------------- +Editor windows +^^^^^^^^^^^^^^ + +IDLE may open editor windows when it starts, depending on settings +and how you start IDLE. Thereafter, use the File menu. There can be only +one open editor window for a given file. + +The title bar contains the name of the file, the full path, and the version +of Python and IDLE running the window. The status bar contains the line +number ('Ln') and column number ('Col'). Line numbers start with 1; +column numbers with 0. + +IDLE assumes that files with a known .py* extension contain Python code +and that other files do not. Run Python code with the Run menu. + +Key bindings +^^^^^^^^^^^^ + In this section, 'C' refers to the :kbd:`Control` key on Windows and Unix and the :kbd:`Command` key on Mac OSX. @@ -397,7 +415,6 @@ the :kbd:`Command` key on Mac OSX. Standard keybindings (like :kbd:`C-c` to copy and :kbd:`C-v` to paste) may work. Keybindings are selected in the Configure IDLE dialog. - Automatic indentation ^^^^^^^^^^^^^^^^^^^^^ diff --git a/Lib/idlelib/help.html b/Lib/idlelib/help.html index b8fecce..24fd77d 100644 --- a/Lib/idlelib/help.html +++ b/Lib/idlelib/help.html @@ -381,6 +381,20 @@ the code above and the prompt below down to a ‘Squeezed text’ label.

Editing and navigation

+
+

Editor windows

+

IDLE may open editor windows when it starts, depending on settings +and how you start IDLE. Thereafter, use the File menu. There can be only +one open editor window for a given file.

+

The title bar contains the name of the file, the full path, and the version +of Python and IDLE running the window. The status bar contains the line +number (‘Ln’) and column number (‘Col’). Line numbers start with 1; +column numbers with 0.

+

IDLE assumes that files with a known .py* extension contain Python code +and that other files do not. Run Python code with the Run menu.

+
+
+

Key bindings

In this section, ‘C’ refers to the Control key on Windows and Unix and the Command key on Mac OSX.

    @@ -416,6 +430,7 @@ this)

Standard keybindings (like C-c to copy and C-v to paste) may work. Keybindings are selected in the Configure IDLE dialog.

+

Automatic indentation

After a block-opening statement, the next line is indented by 4 spaces (in the @@ -725,6 +740,8 @@ also used for testing.

  • Editing and navigation
      +
    • Editor windows
      • +
    • Key bindings
    • Automatic indentation
    • Completions
    • Calltips
      • diff --git a/Misc/NEWS.d/next/IDLE/2018-10-28-20-17-14.bpo-35097.07tm66.rst b/Misc/NEWS.d/next/IDLE/2018-10-28-20-17-14.bpo-35097.07tm66.rst new file mode 100644 index 0000000..a1e58ee --- /dev/null +++ b/Misc/NEWS.d/next/IDLE/2018-10-28-20-17-14.bpo-35097.07tm66.rst @@ -0,0 +1,2 @@ +Add IDLE doc subsection explaining editor windows. Topics include opening, +title and status bar, .py* extension, and running. -- cgit v0.12