Issue #22820: Explain need for *print* when running file from Idle editor.
diff --git a/Doc/library/idle.rst b/Doc/library/idle.rst
index bbbeaa2..c149aa9 100644
--- a/Doc/library/idle.rst
+++ b/Doc/library/idle.rst
@@ -206,7 +206,12 @@
Run Module
Do Check Module (above). If no error, restart the shell to clean the
- environment, then execute the module.
+ environment, then execute the module. Output is displayed in the Shell
+ window. Note that output requires use of ``print`` or ``write``.
+ When execution is complete, the Shell retains focus and displays a prompt.
+ At this point, one may interactively explore the result of execution.
+ This is similar to executing a file with ``python -i file`` at a command
+ line.
Shell menu (Shell window only)
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
diff --git a/Lib/idlelib/help.html b/Lib/idlelib/help.html
index b2948a3..1324c32 100644
--- a/Lib/idlelib/help.html
+++ b/Lib/idlelib/help.html
@@ -223,7 +223,12 @@
Editor window.</dd>
<dt>Run Module</dt>
<dd>Do Check Module (above). If no error, restart the shell to clean the
-environment, then execute the module.</dd>
+environment, then execute the module. Output is displayed in the Shell
+window. Note that output requires use of <tt class="docutils literal"><span class="pre">print</span></tt> or <tt class="docutils literal"><span class="pre">write</span></tt>.
+When execution is complete, the Shell retains focus and displays a prompt.
+At this point, one may interactively explore the result of execution.
+This is similar to executing a file with <tt class="docutils literal"><span class="pre">python</span> <span class="pre">-i</span> <span class="pre">file</span></tt> at a command
+line.</dd>
</dl>
</div>
<div class="section" id="shell-menu-shell-window-only">
@@ -676,7 +681,7 @@
The Python Software Foundation is a non-profit corporation.
<a href="https://www.python.org/psf/donations/">Please donate.</a>
<br />
- Last updated on Sep 23, 2015.
+ Last updated on Sep 24, 2015.
<a href="../bugs.html">Found a bug</a>?
<br />
Created using <a href="http://sphinx.pocoo.org/">Sphinx</a> 1.2.3.