From: Miss Islington (bot) <31488909+miss-islington@users.noreply.github.com> Date: Mon, 29 Oct 2018 01:51:45 +0000 (-0700) Subject: bpo-35097: Add IDLE doc subsection explaining editor windows. (GH-10206) X-Git-Tag: v3.6.8rc1~165 X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;h=9bdadc163f306ddb4659c6732ea24401957488db;p=thirdparty%2FPython%2Fcpython.git bpo-35097: Add IDLE doc subsection explaining editor windows. (GH-10206) Topics include opening, title and status bar, .py* extension, and running. (cherry picked from commit ea9c8bd44365ae8b0accc5286c7b52862528c0ec) Co-authored-by: Terry Jan Reedy --- diff --git a/Doc/library/idle.rst b/Doc/library/idle.rst index 3bf87c25a8d5..0826d99b6336 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 b8fecce0c9a2..24fd77da904e 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 000000000000..a1e58ee5983c --- /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.