From: Terry Jan Reedy <tjreedy@udel.edu>
Date: Thu, 24 Sep 2015 05:39:25 +0000 (-0400)
Subject: Issue #22820: Explain need for *print* when running file from Idle editor.
X-Git-Tag: v2.7.11rc1~121
X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;h=cf5bf82e59c7436ec0af6a7e2771bf1208d4a71b;p=thirdparty%2FPython%2Fcpython.git

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 bbbeaa2e2f73..c149aa91a35d 100644
--- a/Doc/library/idle.rst
+++ b/Doc/library/idle.rst
@@ -206,7 +206,12 @@ Check Module
 
 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 b2948a342886..1324c327244a 100644
--- a/Lib/idlelib/help.html
+++ b/Lib/idlelib/help.html
@@ -223,7 +223,12 @@ there is a syntax error, the approximate location is indicated in the
 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 @@ are currently:</p>
     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.