From 3b8c749464ce65f9ab6bd5d4ce78e2e8eda1d4b5 Mon Sep 17 00:00:00 2001 From: Terry Jan Reedy Date: Sun, 28 Oct 2018 03:47:07 -0400 Subject: [PATCH 1/2] bpo-1529353: Explain Shell text squeezing in the IDLE doc. --- Doc/library/idle.rst | 19 ++++++++++++++++++- Lib/idlelib/help.html | 20 ++++++++++++++++++-- 2 files changed, 36 insertions(+), 3 deletions(-) diff --git a/Doc/library/idle.rst b/Doc/library/idle.rst index 0eb1b44f8022205..e91a00075e31f55 100644 --- a/Doc/library/idle.rst +++ b/Doc/library/idle.rst @@ -341,11 +341,18 @@ Set Breakpoint Clear Breakpoint Clear the breakpoint on that line. -Shell and Output windows have the following. +Shell and Output windows also have the following. Go to file/line Same as in Debug menu. +The Shell window also has an output squeezing facility explained in the +the *Python Shell window* subsection below. + +Squeeze + If the cursor is over an output line, squeeze all the output between + the code above and the prompt below down to a 'Squeezed text' button. + Editing and navigation ---------------------- @@ -477,6 +484,9 @@ or immediately run an existing file before editing. Python Shell window ^^^^^^^^^^^^^^^^^^^ +IDLE's Shell window is a specialized editor window that also responds +to the following keys. + * :kbd:`C-c` interrupts executing command * :kbd:`C-d` sends end-of-file; closes window if typed at a ``>>>`` prompt @@ -492,6 +502,13 @@ Python Shell window * :kbd:`Return` while on any previous command retrieves that command +Shell also has a special facility for squeezing output lines down to a +'Squeezed text' button. This is done automatically for output over N lines +(N = 50 by default). N can be changed in the PyShell section of the General +page of the Settings dialog. Fewer lines can be squeezed by right clicking +on the output. This can be useful for extra long lines. Squeezed output can +be expanded in place by double-clicking the button. It can instead be sent +to the clipboard or a separate view window by right-clicking the button. Text colors ^^^^^^^^^^^ diff --git a/Lib/idlelib/help.html b/Lib/idlelib/help.html index 32676195bb525d0..4b4f6d110a04f9d 100644 --- a/Lib/idlelib/help.html +++ b/Lib/idlelib/help.html @@ -364,11 +364,18 @@

Help menu (Shell and Editor)
Go to file/line
Same as in Debug menu.
+

The Shell window also has an output squeezing facility explained in the +the Python Shell window subsection below.

+
+
Squeeze
+
If the cursor is over an output line, squeeze all the output between +the code above and the prompt below down to a ‘Squeezed text’ button.
+
@@ -478,6 +485,8 @@

Calltips

Python Shell window

+

IDLE’s Shell window is a specialized editor window that also responds +to the following keys.

  • C-c interrupts executing command

    • @@ -493,6 +502,13 @@

    Python Shell window

    Text colors

    @@ -797,7 +813,7 @@

    Navigation



    - Last updated on Oct 27, 2018. + Last updated on Oct 28, 2018. Found a bug?
    From 04da4ff4a8d258cca362a5cb43c01561e2607f87 Mon Sep 17 00:00:00 2001 From: Terry Jan Reedy Date: Sun, 28 Oct 2018 12:24:03 -0400 Subject: [PATCH 2/2] Apply Tal's comments. --- Doc/library/idle.rst | 20 +++++++++++--------- Lib/idlelib/help.html | 19 ++++++++++--------- 2 files changed, 21 insertions(+), 18 deletions(-) diff --git a/Doc/library/idle.rst b/Doc/library/idle.rst index e91a00075e31f55..aaf4e9e0d59a789 100644 --- a/Doc/library/idle.rst +++ b/Doc/library/idle.rst @@ -351,7 +351,7 @@ the *Python Shell window* subsection below. Squeeze If the cursor is over an output line, squeeze all the output between - the code above and the prompt below down to a 'Squeezed text' button. + the code above and the prompt below down to a 'Squeezed text' label. Editing and navigation @@ -484,8 +484,8 @@ or immediately run an existing file before editing. Python Shell window ^^^^^^^^^^^^^^^^^^^ -IDLE's Shell window is a specialized editor window that also responds -to the following keys. +The editing features described above work when entering code interactively. +IDLE's Shell window also responds to the following keys. * :kbd:`C-c` interrupts executing command @@ -502,13 +502,15 @@ to the following keys. * :kbd:`Return` while on any previous command retrieves that command -Shell also has a special facility for squeezing output lines down to a -'Squeezed text' button. This is done automatically for output over N lines +Shell has a special facility for squeezing output lines down to a +'Squeezed text' label. This is done automatically for output over N lines (N = 50 by default). N can be changed in the PyShell section of the General -page of the Settings dialog. Fewer lines can be squeezed by right clicking -on the output. This can be useful for extra long lines. Squeezed output can -be expanded in place by double-clicking the button. It can instead be sent -to the clipboard or a separate view window by right-clicking the button. +page of the Settings dialog. Output with fewer lines can be squeezed by +right clicking on the output. This can be useful for extra long lines. + +Squeezed output is expanded in place by double-clicking the label. +It can also be sent to the clipboard or a separate view window by +right-clicking the label. Text colors ^^^^^^^^^^^ diff --git a/Lib/idlelib/help.html b/Lib/idlelib/help.html index 4b4f6d110a04f9d..684d75d09ab9780 100644 --- a/Lib/idlelib/help.html +++ b/Lib/idlelib/help.html @@ -374,7 +374,7 @@

    Help menu (Shell and Editor)
    Squeeze
    If the cursor is over an output line, squeeze all the output between -the code above and the prompt below down to a ‘Squeezed text’ button.
    +the code above and the prompt below down to a ‘Squeezed text’ label.

@@ -485,8 +485,8 @@

Calltips

Python Shell window

-

IDLE’s Shell window is a specialized editor window that also responds -to the following keys.

+

The editing features described above work when entering code interactively. +IDLE’s Shell window also responds to the following keys.

  • C-c interrupts executing command

    • @@ -502,13 +502,14 @@

    Python Shell window

    Text colors