diff options
| author | Terry Jan Reedy <tjreedy@udel.edu> | 2021-02-21 07:44:11 (GMT) |
|---|---|---|
| committer | GitHub <noreply@github.com> | 2021-02-21 07:44:11 (GMT) |
| commit | 4cf7bb8e22bf37e6d65bf4cb5618d09c4a8ad612 (patch) | |
| tree | 75e59b9027e1a469e65eb9ae1f1983b61161b4d5 | |
| parent | 2f9ef514fb24b6a95bd3272885f197752810c107 (diff) | |
| download | cpython-4cf7bb8e22bf37e6d65bf4cb5618d09c4a8ad612.zip cpython-4cf7bb8e22bf37e6d65bf4cb5618d09c4a8ad612.tar.gz cpython-4cf7bb8e22bf37e6d65bf4cb5618d09c4a8ad612.tar.bz2 | |
bpo-43283: Rearrange some IDLE doc paragraphs. (GH-24604)
In the Running User Code section, gather together paragraphs about two
processes and the sys.stdstream replacements, preparing to add another.
| -rw-r--r-- | Doc/library/idle.rst | 29 | ||||
| -rw-r--r-- | Lib/idlelib/help.html | 44 |
2 files changed, 37 insertions, 36 deletions
diff --git a/Doc/library/idle.rst b/Doc/library/idle.rst index e7eaabd..fc45e31 100644 --- a/Doc/library/idle.rst +++ b/Doc/library/idle.rst @@ -726,28 +726,29 @@ with objects that get input from and send output to the Shell window. The original values stored in ``sys.__stdin__``, ``sys.__stdout__``, and ``sys.__stderr__`` are not touched, but may be ``None``. -When Shell has the focus, it controls the keyboard and screen. This is -normally transparent, but functions that directly access the keyboard -and screen will not work. These include system-specific functions that -determine whether a key has been pressed and if so, which. - IDLE's standard stream replacements are not inherited by subprocesses -created in the execution process, whether directly by user code or by modules -such as multiprocessing. If such subprocess use ``input`` from sys.stdin -or ``print`` or ``write`` to sys.stdout or sys.stderr, +created in the execution process, whether directly by user code or by +modules such as multiprocessing. If such subprocess use ``input`` from +sys.stdin or ``print`` or ``write`` to sys.stdout or sys.stderr, IDLE should be started in a command line window. The secondary subprocess will then be attached to that window for input and output. -The IDLE code running in the execution process adds frames to the call stack -that would not be there otherwise. IDLE wraps ``sys.getrecursionlimit`` and -``sys.setrecursionlimit`` to reduce the effect of the additional stack frames. - If ``sys`` is reset by user code, such as with ``importlib.reload(sys)``, IDLE's changes are lost and input from the keyboard and output to the screen will not work correctly. -When user code raises SystemExit either directly or by calling sys.exit, IDLE -returns to a Shell prompt instead of exiting. +When Shell has the focus, it controls the keyboard and screen. This is +normally transparent, but functions that directly access the keyboard +and screen will not work. These include system-specific functions that +determine whether a key has been pressed and if so, which. + +The IDLE code running in the execution process adds frames to the call stack +that would not be there otherwise. IDLE wraps ``sys.getrecursionlimit`` and +``sys.setrecursionlimit`` to reduce the effect of the additional stack +frames. + +When user code raises SystemExit either directly or by calling sys.exit, +IDLE returns to a Shell prompt instead of exiting. User output in Shell ^^^^^^^^^^^^^^^^^^^^ diff --git a/Lib/idlelib/help.html b/Lib/idlelib/help.html index 170999e..1eefa50 100644 --- a/Lib/idlelib/help.html +++ b/Lib/idlelib/help.html @@ -5,7 +5,7 @@ <head> <meta charset="utf-8" /> <meta name="viewport" content="width=device-width, initial-scale=1.0" /> - <title>IDLE — Python 3.10.0a1 documentation</title> + <title>IDLE — Python 3.10.0a5 documentation</title> <link rel="stylesheet" href="../_static/pydoctheme.css" type="text/css" /> <link rel="stylesheet" href="../_static/pygments.css" type="text/css" /> @@ -18,7 +18,7 @@ <script src="../_static/sidebar.js"></script> <link rel="search" type="application/opensearchdescription+xml" - title="Search within Python 3.10.0a1 documentation" + title="Search within Python 3.10.0a5 documentation" href="../_static/opensearch.xml"/> <link rel="author" title="About these documents" href="../about.html" /> <link rel="index" title="Index" href="../genindex.html" /> @@ -32,7 +32,6 @@ - <style> @media only screen { table.full-width-table { @@ -71,8 +70,8 @@ <li><a href="https://www.python.org/">Python</a> »</li> - <li> - <a href="../index.html">3.10.0a1 Documentation</a> » + <li id="cpython-language-and-version"> + <a href="../index.html">3.10.0a5 Documentation</a> » </li> <li class="nav-item nav-item-1"><a href="index.html" >The Python Standard Library</a> »</li> @@ -285,7 +284,7 @@ Editor window.</p> <dl class="simple"> <dt>View Last Restart</dt><dd><p>Scroll the shell window to the last Shell restart.</p> </dd> -<dt>Restart Shell</dt><dd><p>Restart the shell to clean the environment.</p> +<dt>Restart Shell</dt><dd><p>Restart the shell to clean the environment and reset display and exception handling.</p> </dd> <dt>Previous History</dt><dd><p>Cycle through earlier commands in history which match the current entry.</p> </dd> @@ -680,24 +679,25 @@ process, it replaces <code class="docutils literal notranslate"><span class="pre with objects that get input from and send output to the Shell window. The original values stored in <code class="docutils literal notranslate"><span class="pre">sys.__stdin__</span></code>, <code class="docutils literal notranslate"><span class="pre">sys.__stdout__</span></code>, and <code class="docutils literal notranslate"><span class="pre">sys.__stderr__</span></code> are not touched, but may be <code class="docutils literal notranslate"><span class="pre">None</span></code>.</p> -<p>When Shell has the focus, it controls the keyboard and screen. This is -normally transparent, but functions that directly access the keyboard -and screen will not work. These include system-specific functions that -determine whether a key has been pressed and if so, which.</p> <p>IDLE’s standard stream replacements are not inherited by subprocesses -created in the execution process, whether directly by user code or by modules -such as multiprocessing. If such subprocess use <code class="docutils literal notranslate"><span class="pre">input</span></code> from sys.stdin -or <code class="docutils literal notranslate"><span class="pre">print</span></code> or <code class="docutils literal notranslate"><span class="pre">write</span></code> to sys.stdout or sys.stderr, +created in the execution process, whether directly by user code or by +modules such as multiprocessing. If such subprocess use <code class="docutils literal notranslate"><span class="pre">input</span></code> from +sys.stdin or <code class="docutils literal notranslate"><span class="pre">print</span></code> or <code class="docutils literal notranslate"><span class="pre">write</span></code> to sys.stdout or sys.stderr, IDLE should be started in a command line window. The secondary subprocess will then be attached to that window for input and output.</p> -<p>The IDLE code running in the execution process adds frames to the call stack -that would not be there otherwise. IDLE wraps <code class="docutils literal notranslate"><span class="pre">sys.getrecursionlimit</span></code> and -<code class="docutils literal notranslate"><span class="pre">sys.setrecursionlimit</span></code> to reduce the effect of the additional stack frames.</p> <p>If <code class="docutils literal notranslate"><span class="pre">sys</span></code> is reset by user code, such as with <code class="docutils literal notranslate"><span class="pre">importlib.reload(sys)</span></code>, IDLE’s changes are lost and input from the keyboard and output to the screen will not work correctly.</p> -<p>When user code raises SystemExit either directly or by calling sys.exit, IDLE -returns to a Shell prompt instead of exiting.</p> +<p>When Shell has the focus, it controls the keyboard and screen. This is +normally transparent, but functions that directly access the keyboard +and screen will not work. These include system-specific functions that +determine whether a key has been pressed and if so, which.</p> +<p>The IDLE code running in the execution process adds frames to the call stack +that would not be there otherwise. IDLE wraps <code class="docutils literal notranslate"><span class="pre">sys.getrecursionlimit</span></code> and +<code class="docutils literal notranslate"><span class="pre">sys.setrecursionlimit</span></code> to reduce the effect of the additional stack +frames.</p> +<p>When user code raises SystemExit either directly or by calling sys.exit, +IDLE returns to a Shell prompt instead of exiting.</p> </div> <div class="section" id="user-output-in-shell"> <h3>User output in Shell<a class="headerlink" href="#user-output-in-shell" title="Permalink to this headline">¶</a></h3> @@ -949,8 +949,8 @@ also used for testing.</p> <li><a href="https://www.python.org/">Python</a> »</li> - <li> - <a href="../index.html">3.10.0a1 Documentation</a> » + <li id="cpython-language-and-version"> + <a href="../index.html">3.10.0a5 Documentation</a> » </li> <li class="nav-item nav-item-1"><a href="index.html" >The Python Standard Library</a> »</li> @@ -974,7 +974,7 @@ also used for testing.</p> </ul> </div> <div class="footer"> - © <a href="../copyright.html">Copyright</a> 2001-2020, Python Software Foundation. + © <a href="../copyright.html">Copyright</a> 2001-2021, Python Software Foundation. <br /> The Python Software Foundation is a non-profit corporation. @@ -982,7 +982,7 @@ also used for testing.</p> <br /> <br /> - Last updated on Oct 20, 2020. + Last updated on Feb 21, 2021. <a href="https://docs.python.org/3/bugs.html">Found a bug</a>? <br /> |