[Python-checkins] bpo-1529353: Explain Shell text squeezing in the IDLE doc. (GH-10169)
Miss Islington (bot)
webhook-mailer at python.org
Sun Oct 28 13:03:22 EDT 2018
https://github.com/python/cpython/commit/8dccb00c197e7b4f6ce65950a9ed6802fa217094
commit: 8dccb00c197e7b4f6ce65950a9ed6802fa217094
branch: 3.7
author: Miss Islington (bot) <31488909+miss-islington at users.noreply.github.com>
committer: GitHub <noreply at github.com>
date: 2018-10-28T10:03:19-07:00
summary:
bpo-1529353: Explain Shell text squeezing in the IDLE doc. (GH-10169)
(cherry picked from commit 68d6dc0770288075504635a8e42696070823fd69)
Co-authored-by: Terry Jan Reedy <tjreedy at udel.edu>
files:
M Doc/library/idle.rst
M Lib/idlelib/help.html
diff --git a/Doc/library/idle.rst b/Doc/library/idle.rst
index 0eb1b44f8022..aaf4e9e0d59a 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 32676195bb52..684d75d09ab9 100644
--- a/Lib/idlelib/help.html
+++ b/Lib/idlelib/help.html
@@ -364,11 +364,18 @@ <h3>Help menu (Shell and Editor)<a class="headerlink" href="#help-menu-shell-and
<dt>Clear Breakpoint</dt>
<dd>Clear the breakpoint on that line.</dd>
</dl>
-<p>Shell and Output windows have the following.</p>
+<p>Shell and Output windows also have the following.</p>
<dl class="docutils">
<dt>Go to file/line</dt>
<dd>Same as in Debug menu.</dd>
</dl>
+<p>The Shell window also has an output squeezing facility explained in the
+the <em>Python Shell window</em> subsection below.</p>
+<dl class="docutils">
+<dt>Squeeze</dt>
+<dd>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.</dd>
+</dl>
</div>
</div>
<div class="section" id="editing-and-navigation">
@@ -478,6 +485,8 @@ <h3>Calltips<a class="headerlink" href="#calltips" title="Permalink to this head
</div>
<div class="section" id="python-shell-window">
<h3>Python Shell window<a class="headerlink" href="#python-shell-window" title="Permalink to this headline">¶</a></h3>
+<p>The editing features described above work when entering code interactively.
+IDLE’s Shell window also responds to the following keys.</p>
<ul>
<li><p class="first"><kbd class="kbd docutils literal notranslate">C-c</kbd> interrupts executing command</p>
</li>
@@ -493,6 +502,14 @@ <h3>Python Shell window<a class="headerlink" href="#python-shell-window" title="
</ul>
</li>
</ul>
+<p>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.</p>
+<p>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.</p>
</div>
<div class="section" id="text-colors">
<h3>Text colors<a class="headerlink" href="#text-colors" title="Permalink to this headline">¶</a></h3>
@@ -797,7 +814,7 @@ <h3>Navigation</h3>
<br />
<br />
- Last updated on Oct 27, 2018.
+ Last updated on Oct 28, 2018.
<a href="https://docs.python.org/3/bugs.html">Found a bug</a>?
<br />
More information about the Python-checkins
mailing list