From 8dccb00c197e7b4f6ce65950a9ed6802fa217094 Mon Sep 17 00:00:00 2001 From: "Miss Islington (bot)" <31488909+miss-islington@users.noreply.github.com> Date: Sun, 28 Oct 2018 10:03:19 -0700 Subject: [PATCH] bpo-1529353: Explain Shell text squeezing in the IDLE doc. (GH-10169) (cherry picked from commit 68d6dc0770288075504635a8e42696070823fd69) Co-authored-by: Terry Jan Reedy --- Doc/library/idle.rst | 21 ++++++++++++++++++++- Lib/idlelib/help.html | 21 +++++++++++++++++++-- 2 files changed, 39 insertions(+), 3 deletions(-) diff --git a/Doc/library/idle.rst b/Doc/library/idle.rst index 0eb1b44f802..aaf4e9e0d59 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' label. + Editing and navigation ---------------------- @@ -477,6 +484,9 @@ or immediately run an existing file before editing. Python Shell window ^^^^^^^^^^^^^^^^^^^ +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 * :kbd:`C-d` sends end-of-file; closes window if typed at a ``>>>`` prompt @@ -492,6 +502,15 @@ Python Shell window * :kbd:`Return` while on any previous command retrieves that command +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. 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 32676195bb5..684d75d09ab 100644 --- a/Lib/idlelib/help.html +++ b/Lib/idlelib/help.html @@ -364,11 +364,18 @@ debugger. Breakpoints for a file are saved in the user’s .idlerc directory.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’ label.
+
@@ -478,6 +485,8 @@ or immediately run an existing file before editing.

Python Shell window

+

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

+

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. 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

@@ -797,7 +814,7 @@ also used for testing.



- Last updated on Oct 27, 2018. + Last updated on Oct 28, 2018. Found a bug?