bpo-1529353: Explain Shell text squeezing in the IDLE doc. (#10169)
diff --git a/Lib/idlelib/help.html b/Lib/idlelib/help.html
index 3267619..684d75d 100644
--- a/Lib/idlelib/help.html
+++ b/Lib/idlelib/help.html
@@ -364,11 +364,18 @@
<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 @@
</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 @@
</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 @@
<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 />