https://github.com/python/cpython/commit/3cf859056a6e745cf056a9cb8b04e367bcbf5409 commit: 3cf859056a6e745cf056a9cb8b04e367bcbf5409 branch: 3.13 author: Miss Islington (bot) <[email protected]> committer: terryjreedy <[email protected]> date: 2025-02-08T20:14:47Z summary:
[3.13] gh-129699: Add description to IDLE doc title (GH-129727) (#129864) gh-129699: Add description to IDLE doc title (GH-129727) Also extend the 'idlelib' section header. These additions affect both the displayed idle.html file and the contents.html file displayed by clicking the Complete table of contents link on the main docs.python.org page. (The module index entries are generated from the module name and synopsis within module files.) --------- (cherry picked from commit 33a7094aa680bca66582fec4dcda7d150eb90cd8) Co-authored-by: Stan Ulbrych <[email protected]> Co-authored-by: Terry Jan Reedy <[email protected]> files: M Doc/library/idle.rst M Lib/idlelib/help.html M Lib/idlelib/help.py M Lib/idlelib/idle_test/test_help.py diff --git a/Doc/library/idle.rst b/Doc/library/idle.rst index 59b181aab3e484..830bc33922d5dd 100644 --- a/Doc/library/idle.rst +++ b/Doc/library/idle.rst @@ -1,7 +1,7 @@ .. _idle: -IDLE -==== +IDLE --- Python editor and shell +================================ .. moduleauthor:: Guido van Rossum <[email protected]> @@ -971,8 +971,8 @@ information. The only current default extension is zzdummy, an example also used for testing. -idlelib -------- +idlelib --- implementation of IDLE application +---------------------------------------------- .. module:: idlelib :synopsis: Implementation package for the IDLE shell/editor. diff --git a/Lib/idlelib/help.html b/Lib/idlelib/help.html index 2a4adc6a4d395f..2200bf29abea66 100644 --- a/Lib/idlelib/help.html +++ b/Lib/idlelib/help.html @@ -1,24 +1,24 @@ <!DOCTYPE html> -<html lang="en"> +<html lang="en" data-content_root="../"> <head> <meta charset="utf-8" /> <meta name="viewport" content="width=device-width, initial-scale=1.0" /><meta name="viewport" content="width=device-width, initial-scale=1" /> - <title>IDLE — Python 3.14.0a0 documentation</title><meta name="viewport" content="width=device-width, initial-scale=1.0"> + <title>IDLE — Python editor and shell — Python 3.14.0a4 documentation</title><meta name="viewport" content="width=device-width, initial-scale=1.0"> - <link rel="stylesheet" type="text/css" href="../_static/pygments.css" /> - <link rel="stylesheet" type="text/css" href="../_static/pydoctheme.css?digest=b37c26da2f7529d09fe70b41c4b2133fe4931a90" /> - <link id="pygments_dark_css" media="(prefers-color-scheme: dark)" rel="stylesheet" type="text/css" href="../_static/pygments_dark.css" /> + <link rel="stylesheet" type="text/css" href="../_static/pygments.css?v=b86133f3" /> + <link rel="stylesheet" type="text/css" href="../_static/pydoctheme.css?v=aa5eeaf2" /> + <link id="pygments_dark_css" media="(prefers-color-scheme: dark)" rel="stylesheet" type="text/css" href="../_static/pygments_dark.css?v=5349f25f" /> - <script data-url_root="../" id="documentation_options" src="../_static/documentation_options.js"></script> - <script src="../_static/doctools.js"></script> - <script src="../_static/sphinx_highlight.js"></script> + <script src="../_static/documentation_options.js?v=058caec0"></script> + <script src="../_static/doctools.js?v=9bcbadda"></script> + <script src="../_static/sphinx_highlight.js?v=dc90522c"></script> <script src="../_static/sidebar.js"></script> <link rel="search" type="application/opensearchdescription+xml" - title="Search within Python 3.14.0a0 documentation" + title="Search within Python 3.14.0a4 documentation" href="../_static/opensearch.xml"/> <link rel="author" title="About these documents" href="../about.html" /> <link rel="index" title="Index" href="../genindex.html" /> @@ -87,7 +87,7 @@ <div> <h3><a href="../contents.html">Table of Contents</a></h3> <ul> -<li><a class="reference internal" href="#">IDLE</a><ul> +<li><a class="reference internal" href="#">IDLE — Python editor and shell</a><ul> <li><a class="reference internal" href="#menus">Menus</a><ul> <li><a class="reference internal" href="#file-menu-shell-and-editor">File menu (Shell and Editor)</a></li> <li><a class="reference internal" href="#edit-menu-shell-and-editor">Edit menu (Shell and Editor)</a></li> @@ -129,7 +129,7 @@ <h3><a href="../contents.html">Table of Contents</a></h3> <li><a class="reference internal" href="#extensions">Extensions</a></li> </ul> </li> -<li><a class="reference internal" href="#module-idlelib">idlelib</a></li> +<li><a class="reference internal" href="#module-idlelib">idlelib — implementation of IDLE application</a></li> </ul> </li> </ul> @@ -161,7 +161,7 @@ <h3>This Page</h3> </div> - <div class="related" role="navigation" aria-label="related navigation"> + <div class="related" role="navigation" aria-label="Related"> <h3>Navigation</h3> <ul> <li class="right" style="margin-right: 10px"> @@ -187,12 +187,12 @@ <h3>Navigation</h3> </li> <li id="cpython-language-and-version"> - <a href="../index.html">3.14.0a0 Documentation</a> » + <a href="../index.html">3.14.0a4 Documentation</a> » </li> <li class="nav-item nav-item-1"><a href="index.html" >The Python Standard Library</a> »</li> <li class="nav-item nav-item-2"><a href="tk.html" accesskey="U">Graphical User Interfaces with Tk</a> »</li> - <li class="nav-item nav-item-this"><a href="">IDLE</a></li> + <li class="nav-item nav-item-this"><a href="">IDLE — Python editor and shell</a></li> <li class="right"> @@ -223,8 +223,8 @@ <h3>Navigation</h3> <div class="body" role="main"> <section id="idle"> -<span id="id1"></span><h1>IDLE<a class="headerlink" href="#idle" title="Permalink to this heading">¶</a></h1> -<p><strong>Source code:</strong> <a class="reference external" href="https://github.com/python/cpython/tree/main/Lib/idlelib/";>Lib/idlelib/</a></p> +<span id="idle-python-editor-and-shell"></span><h1>IDLE — Python editor and shell<a class="headerlink" href="#idle" title="Link to this heading">¶</a></h1> +<p><strong>Source code:</strong> <a class="extlink-source reference external" href="https://github.com/python/cpython/tree/main/Lib/idlelib/";>Lib/idlelib/</a></p> <hr class="docutils" id="index-0" /> <p>IDLE is Python’s Integrated Development and Learning Environment.</p> <p>IDLE has the following features:</p> @@ -241,7 +241,7 @@ <h3>Navigation</h3> <li><p>configuration, browsers, and other dialogs</p></li> </ul> <section id="menus"> -<h2>Menus<a class="headerlink" href="#menus" title="Permalink to this heading">¶</a></h2> +<h2>Menus<a class="headerlink" href="#menus" title="Link to this heading">¶</a></h2> <p>IDLE has two main window types, the Shell window and the Editor window. It is possible to have multiple editor windows simultaneously. On Windows and Linux, each has its own top menu. Each menu documented below indicates @@ -253,7 +253,7 @@ <h2>Menus<a class="headerlink" href="#menus" title="Permalink to this heading"> to the window currently selected. It has an IDLE menu, and some entries described below are moved around to conform to Apple guidelines.</p> <section id="file-menu-shell-and-editor"> -<h3>File menu (Shell and Editor)<a class="headerlink" href="#file-menu-shell-and-editor" title="Permalink to this heading">¶</a></h3> +<h3>File menu (Shell and Editor)<a class="headerlink" href="#file-menu-shell-and-editor" title="Link to this heading">¶</a></h3> <dl class="simple"> <dt>New File</dt><dd><p>Create a new file editing window.</p> </dd> @@ -296,7 +296,7 @@ <h3>File menu (Shell and Editor)<a class="headerlink" href="#file-menu-shell-and </dl> </section> <section id="edit-menu-shell-and-editor"> -<h3>Edit menu (Shell and Editor)<a class="headerlink" href="#edit-menu-shell-and-editor" title="Permalink to this heading">¶</a></h3> +<h3>Edit menu (Shell and Editor)<a class="headerlink" href="#edit-menu-shell-and-editor" title="Link to this heading">¶</a></h3> <dl class="simple"> <dt>Undo</dt><dd><p>Undo the last change to the current window. A maximum of 1000 changes may be undone.</p> @@ -343,7 +343,7 @@ <h3>Edit menu (Shell and Editor)<a class="headerlink" href="#edit-menu-shell-and </dl> </section> <section id="format-menu-editor-window-only"> -<span id="format-menu"></span><h3>Format menu (Editor window only)<a class="headerlink" href="#format-menu-editor-window-only" title="Permalink to this heading">¶</a></h3> +<span id="format-menu"></span><h3>Format menu (Editor window only)<a class="headerlink" href="#format-menu-editor-window-only" title="Link to this heading">¶</a></h3> <dl class="simple"> <dt>Format Paragraph</dt><dd><p>Reformat the current blank-line-delimited paragraph in comment block or multiline string or selected line in a string. All lines in the @@ -375,7 +375,7 @@ <h3>Edit menu (Shell and Editor)<a class="headerlink" href="#edit-menu-shell-and </dl> </section> <section id="run-menu-editor-window-only"> -<span id="index-2"></span><h3>Run menu (Editor window only)<a class="headerlink" href="#run-menu-editor-window-only" title="Permalink to this heading">¶</a></h3> +<span id="index-2"></span><h3>Run menu (Editor window only)<a class="headerlink" href="#run-menu-editor-window-only" title="Link to this heading">¶</a></h3> <dl class="simple" id="run-module"> <dt>Run Module</dt><dd><p>Do <a class="reference internal" href="#check-module"><span class="std std-ref">Check Module</span></a>. If no error, restart the shell to clean the environment, then execute the module. Output is displayed in the Shell @@ -406,7 +406,7 @@ <h3>Edit menu (Shell and Editor)<a class="headerlink" href="#edit-menu-shell-and </dl> </section> <section id="shell-menu-shell-window-only"> -<h3>Shell menu (Shell window only)<a class="headerlink" href="#shell-menu-shell-window-only" title="Permalink to this heading">¶</a></h3> +<h3>Shell menu (Shell window only)<a class="headerlink" href="#shell-menu-shell-window-only" title="Link to this heading">¶</a></h3> <dl class="simple"> <dt>View Last Restart</dt><dd><p>Scroll the shell window to the last Shell restart.</p> </dd> @@ -421,7 +421,7 @@ <h3>Shell menu (Shell window only)<a class="headerlink" href="#shell-menu-shell- </dl> </section> <section id="debug-menu-shell-window-only"> -<h3>Debug menu (Shell window only)<a class="headerlink" href="#debug-menu-shell-window-only" title="Permalink to this heading">¶</a></h3> +<h3>Debug menu (Shell window only)<a class="headerlink" href="#debug-menu-shell-window-only" title="Link to this heading">¶</a></h3> <dl class="simple"> <dt>Go to File/Line</dt><dd><p>Look on the current line. with the cursor, and the line above for a filename and line number. If found, open the file if not already open, and show the @@ -443,7 +443,7 @@ <h3>Debug menu (Shell window only)<a class="headerlink" href="#debug-menu-shell- </dl> </section> <section id="options-menu-shell-and-editor"> -<h3>Options menu (Shell and Editor)<a class="headerlink" href="#options-menu-shell-and-editor" title="Permalink to this heading">¶</a></h3> +<h3>Options menu (Shell and Editor)<a class="headerlink" href="#options-menu-shell-and-editor" title="Link to this heading">¶</a></h3> <dl class="simple"> <dt>Configure IDLE</dt><dd><p>Open a configuration dialog and change preferences for the following: fonts, indentation, keybindings, text color themes, startup windows and @@ -475,12 +475,12 @@ <h3>Options menu (Shell and Editor)<a class="headerlink" href="#options-menu-she </dl> </section> <section id="window-menu-shell-and-editor"> -<h3>Window menu (Shell and Editor)<a class="headerlink" href="#window-menu-shell-and-editor" title="Permalink to this heading">¶</a></h3> +<h3>Window menu (Shell and Editor)<a class="headerlink" href="#window-menu-shell-and-editor" title="Link to this heading">¶</a></h3> <p>Lists the names of all open windows; select one to bring it to the foreground (deiconifying it if necessary).</p> </section> <section id="help-menu-shell-and-editor"> -<h3>Help menu (Shell and Editor)<a class="headerlink" href="#help-menu-shell-and-editor" title="Permalink to this heading">¶</a></h3> +<h3>Help menu (Shell and Editor)<a class="headerlink" href="#help-menu-shell-and-editor" title="Link to this heading">¶</a></h3> <dl class="simple"> <dt>About IDLE</dt><dd><p>Display version, copyright, license, credits, and more.</p> </dd> @@ -498,7 +498,7 @@ <h3>Help menu (Shell and Editor)<a class="headerlink" href="#help-menu-shell-and for more on Help menu choices.</p> </section> <section id="context-menus"> -<span id="index-4"></span><h3>Context menus<a class="headerlink" href="#context-menus" title="Permalink to this heading">¶</a></h3> +<span id="index-4"></span><h3>Context menus<a class="headerlink" href="#context-menus" title="Link to this heading">¶</a></h3> <p>Open a context menu by right-clicking in a window (Control-click on macOS). Context menus have the standard clipboard functions also on the Edit menu.</p> <dl class="simple"> @@ -534,9 +534,9 @@ <h3>Help menu (Shell and Editor)<a class="headerlink" href="#help-menu-shell-and </section> </section> <section id="editing-and-navigation"> -<span id="id2"></span><h2>Editing and Navigation<a class="headerlink" href="#editing-and-navigation" title="Permalink to this heading">¶</a></h2> +<span id="id1"></span><h2>Editing and Navigation<a class="headerlink" href="#editing-and-navigation" title="Link to this heading">¶</a></h2> <section id="editor-windows"> -<h3>Editor windows<a class="headerlink" href="#editor-windows" title="Permalink to this heading">¶</a></h3> +<h3>Editor windows<a class="headerlink" href="#editor-windows" title="Link to this heading">¶</a></h3> <p>IDLE may open editor windows when it starts, depending on settings and how you start IDLE. Thereafter, use the File menu. There can be only one open editor window for a given file.</p> @@ -548,7 +548,7 @@ <h3>Editor windows<a class="headerlink" href="#editor-windows" title="Permalink and that other files do not. Run Python code with the Run menu.</p> </section> <section id="key-bindings"> -<h3>Key bindings<a class="headerlink" href="#key-bindings" title="Permalink to this heading">¶</a></h3> +<h3>Key bindings<a class="headerlink" href="#key-bindings" title="Link to this heading">¶</a></h3> <p>The IDLE insertion cursor is a thin vertical bar between character positions. When characters are entered, the insertion cursor and everything to its right moves right one character and @@ -574,7 +574,7 @@ <h3>Key bindings<a class="headerlink" href="#key-bindings" title="Permalink to t may work. Keybindings are selected in the Configure IDLE dialog.</p> </section> <section id="automatic-indentation"> -<h3>Automatic indentation<a class="headerlink" href="#automatic-indentation" title="Permalink to this heading">¶</a></h3> +<h3>Automatic indentation<a class="headerlink" href="#automatic-indentation" title="Link to this heading">¶</a></h3> <p>After a block-opening statement, the next line is indented by 4 spaces (in the Python Shell window by one tab). After certain keywords (break, return etc.) the next line is dedented. In leading indentation, <kbd class="kbd docutils literal notranslate">Backspace</kbd> deletes up @@ -585,14 +585,14 @@ <h3>Automatic indentation<a class="headerlink" href="#automatic-indentation" tit <a class="reference internal" href="#format-menu"><span class="std std-ref">Format menu</span></a>.</p> </section> <section id="search-and-replace"> -<h3>Search and Replace<a class="headerlink" href="#search-and-replace" title="Permalink to this heading">¶</a></h3> +<h3>Search and Replace<a class="headerlink" href="#search-and-replace" title="Link to this heading">¶</a></h3> <p>Any selection becomes a search target. However, only selections within a line work because searches are only performed within lines with the terminal newline removed. If <code class="docutils literal notranslate"><span class="pre">[x]</span> <span class="pre">Regular</span> <span class="pre">expression</span></code> is checked, the target is interpreted according to the Python re module.</p> </section> <section id="completions"> -<span id="id3"></span><h3>Completions<a class="headerlink" href="#completions" title="Permalink to this heading">¶</a></h3> +<span id="id2"></span><h3>Completions<a class="headerlink" href="#completions" title="Link to this heading">¶</a></h3> <p>Completions are supplied, when requested and available, for module names, attributes of classes or functions, or filenames. Each request method displays a completion box with existing names. (See tab @@ -636,7 +636,7 @@ <h3>Search and Replace<a class="headerlink" href="#search-and-replace" title="Pe by typing ‘_’ after ‘.’, either before or after the box is opened.</p> </section> <section id="calltips"> -<span id="id4"></span><h3>Calltips<a class="headerlink" href="#calltips" title="Permalink to this heading">¶</a></h3> +<span id="id3"></span><h3>Calltips<a class="headerlink" href="#calltips" title="Link to this heading">¶</a></h3> <p>A calltip is shown automatically when one types <kbd class="kbd docutils literal notranslate">(</kbd> after the name of an <em>accessible</em> function. A function name expression may include dots and subscripts. A calltip remains until it is clicked, the cursor @@ -662,7 +662,7 @@ <h3>Search and Replace<a class="headerlink" href="#search-and-replace" title="Pe adding function definitions, or after opening an existing file.</p> </section> <section id="code-context"> -<span id="id5"></span><h3>Code Context<a class="headerlink" href="#code-context" title="Permalink to this heading">¶</a></h3> +<span id="id4"></span><h3>Code Context<a class="headerlink" href="#code-context" title="Link to this heading">¶</a></h3> <p>Within an editor window containing Python code, code context can be toggled in order to show or hide a pane at the top of the window. When shown, this pane freezes the opening lines for block code, such as those beginning with @@ -677,7 +677,7 @@ <h3>Search and Replace<a class="headerlink" href="#search-and-replace" title="Pe the Highlights tab in the Configure IDLE dialog.</p> </section> <section id="shell-window"> -<h3>Shell window<a class="headerlink" href="#shell-window" title="Permalink to this heading">¶</a></h3> +<h3>Shell window<a class="headerlink" href="#shell-window" title="Link to this heading">¶</a></h3> <p>In IDLE’s Shell, enter, edit, and recall complete statements. (Most consoles and terminals only work with a single physical line at a time).</p> <p>Submit a single-line statement for execution by hitting <kbd class="kbd docutils literal notranslate">Return</kbd> @@ -707,7 +707,7 @@ <h3>Shell window<a class="headerlink" href="#shell-window" title="Permalink to t </ul> </section> <section id="text-colors"> -<h3>Text colors<a class="headerlink" href="#text-colors" title="Permalink to this heading">¶</a></h3> +<h3>Text colors<a class="headerlink" href="#text-colors" title="Link to this heading">¶</a></h3> <p>Idle defaults to black on white text, but colors text with special meanings. For the shell, these are shell output, shell error, user output, and user error. For Python code, at the shell prompt or in an editor, these are @@ -726,7 +726,7 @@ <h3>Text colors<a class="headerlink" href="#text-colors" title="Permalink to thi </section> </section> <section id="startup-and-code-execution"> -<h2>Startup and Code Execution<a class="headerlink" href="#startup-and-code-execution" title="Permalink to this heading">¶</a></h2> +<h2>Startup and Code Execution<a class="headerlink" href="#startup-and-code-execution" title="Link to this heading">¶</a></h2> <p>Upon startup with the <code class="docutils literal notranslate"><span class="pre">-s</span></code> option, IDLE will execute the file referenced by the environment variables <span class="target" id="index-5"></span><code class="xref std std-envvar docutils literal notranslate"><span class="pre">IDLESTARTUP</span></code> or <span class="target" id="index-6"></span><a class="reference internal" href="../using/cmdline.html#envvar-PYTHONSTARTUP"><code class="xref std std-envvar docutils literal notranslate"><span class="pre">PYTHONSTARTUP</span></code></a>. IDLE first checks for <code class="docutils literal notranslate"><span class="pre">IDLESTARTUP</span></code>; if <code class="docutils literal notranslate"><span class="pre">IDLESTARTUP</span></code> is present the file @@ -740,7 +740,7 @@ <h2>Startup and Code Execution<a class="headerlink" href="#startup-and-code-exec executed in the Tk namespace, so this file is not useful for importing functions to be used from IDLE’s Python shell.</p> <section id="command-line-usage"> -<h3>Command line usage<a class="headerlink" href="#command-line-usage" title="Permalink to this heading">¶</a></h3> +<h3>Command line usage<a class="headerlink" href="#command-line-usage" title="Link to this heading">¶</a></h3> <div class="highlight-none notranslate"><div class="highlight"><pre><span></span>idle.py [-c command] [-d] [-e] [-h] [-i] [-r file] [-s] [-t title] [-] [arg] ... -c command run command in the shell window @@ -765,7 +765,7 @@ <h3>Command line usage<a class="headerlink" href="#command-line-usage" title="Pe </ul> </section> <section id="startup-failure"> -<h3>Startup failure<a class="headerlink" href="#startup-failure" title="Permalink to this heading">¶</a></h3> +<h3>Startup failure<a class="headerlink" href="#startup-failure" title="Link to this heading">¶</a></h3> <p>IDLE uses a socket to communicate between the IDLE GUI process and the user code execution process. A connection must be established whenever the Shell starts or restarts. (The latter is indicated by a divider line that says @@ -817,7 +817,7 @@ <h3>Startup failure<a class="headerlink" href="#startup-failure" title="Permalin then re-configure IDLE to use a font that works better.</p> </section> <section id="running-user-code"> -<h3>Running user code<a class="headerlink" href="#running-user-code" title="Permalink to this heading">¶</a></h3> +<h3>Running user code<a class="headerlink" href="#running-user-code" title="Link to this heading">¶</a></h3> <p>With rare exceptions, the result of executing Python code with IDLE is intended to be the same as executing the same code by the default method, directly with Python in a text-mode system console or terminal window. @@ -861,7 +861,7 @@ <h3>Running user code<a class="headerlink" href="#running-user-code" title="Perm IDLE returns to a Shell prompt instead of exiting.</p> </section> <section id="user-output-in-shell"> -<h3>User output in Shell<a class="headerlink" href="#user-output-in-shell" title="Permalink to this heading">¶</a></h3> +<h3>User output in Shell<a class="headerlink" href="#user-output-in-shell" title="Link to this heading">¶</a></h3> <p>When a program outputs text, the result is determined by the corresponding output device. When IDLE executes user 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 connected to the display area of IDLE’s Shell. Some of @@ -915,7 +915,7 @@ <h3>User output in Shell<a class="headerlink" href="#user-output-in-shell" title right-clicking the label.</p> </section> <section id="developing-tkinter-applications"> -<h3>Developing tkinter applications<a class="headerlink" href="#developing-tkinter-applications" title="Permalink to this heading">¶</a></h3> +<h3>Developing tkinter applications<a class="headerlink" href="#developing-tkinter-applications" title="Link to this heading">¶</a></h3> <p>IDLE is intentionally different from standard Python in order to facilitate development of tkinter programs. Enter <code class="docutils literal notranslate"><span class="pre">import</span> <span class="pre">tkinter</span> <span class="pre">as</span> <span class="pre">tk;</span> <span class="pre">root</span> <span class="pre">=</span> <span class="pre">tk.Tk()</span></code> in standard Python and nothing appears. Enter the same @@ -935,7 +935,7 @@ <h3>Developing tkinter applications<a class="headerlink" href="#developing-tkint re-enable the mainloop call when running in standard Python.</p> </section> <section id="running-without-a-subprocess"> -<h3>Running without a subprocess<a class="headerlink" href="#running-without-a-subprocess" title="Permalink to this heading">¶</a></h3> +<h3>Running without a subprocess<a class="headerlink" href="#running-without-a-subprocess" title="Link to this heading">¶</a></h3> <p>By default, IDLE executes user code in a separate subprocess via a socket, which uses the internal loopback interface. This connection is not externally visible and no data is sent to or received from the internet. @@ -961,9 +961,9 @@ <h3>Running without a subprocess<a class="headerlink" href="#running-without-a-s </section> </section> <section id="help-and-preferences"> -<h2>Help and Preferences<a class="headerlink" href="#help-and-preferences" title="Permalink to this heading">¶</a></h2> +<h2>Help and Preferences<a class="headerlink" href="#help-and-preferences" title="Link to this heading">¶</a></h2> <section id="help-sources"> -<span id="id6"></span><h3>Help sources<a class="headerlink" href="#help-sources" title="Permalink to this heading">¶</a></h3> +<span id="id5"></span><h3>Help sources<a class="headerlink" href="#help-sources" title="Link to this heading">¶</a></h3> <p>Help menu entry “IDLE Help” displays a formatted html version of the IDLE chapter of the Library Reference. The result, in a read-only tkinter text window, is close to what one sees in a web browser. @@ -980,7 +980,7 @@ <h2>Help and Preferences<a class="headerlink" href="#help-and-preferences" title General tab of the Configure IDLE dialog.</p> </section> <section id="setting-preferences"> -<span id="preferences"></span><h3>Setting preferences<a class="headerlink" href="#setting-preferences" title="Permalink to this heading">¶</a></h3> +<span id="preferences"></span><h3>Setting preferences<a class="headerlink" href="#setting-preferences" title="Link to this heading">¶</a></h3> <p>The font preferences, highlighting, keys, and general preferences can be changed via Configure IDLE on the Option menu. Non-default user settings are saved in a <code class="docutils literal notranslate"><span class="pre">.idlerc</span></code> directory in the user’s @@ -998,13 +998,13 @@ <h2>Help and Preferences<a class="headerlink" href="#help-and-preferences" title to older IDLEs.</p> </section> <section id="idle-on-macos"> -<h3>IDLE on macOS<a class="headerlink" href="#idle-on-macos" title="Permalink to this heading">¶</a></h3> +<h3>IDLE on macOS<a class="headerlink" href="#idle-on-macos" title="Link to this heading">¶</a></h3> <p>Under System Preferences: Dock, one can set “Prefer tabs when opening documents” to “Always”. This setting is not compatible with the tk/tkinter GUI framework used by IDLE, and it breaks a few IDLE features.</p> </section> <section id="extensions"> -<h3>Extensions<a class="headerlink" href="#extensions" title="Permalink to this heading">¶</a></h3> +<h3>Extensions<a class="headerlink" href="#extensions" title="Link to this heading">¶</a></h3> <p>IDLE contains an extension facility. Preferences for extensions can be changed with the Extensions tab of the preferences dialog. See the beginning of config-extensions.def in the idlelib directory for further @@ -1013,8 +1013,8 @@ <h3>Extensions<a class="headerlink" href="#extensions" title="Permalink to this </section> </section> <section id="module-idlelib"> -<span id="idlelib"></span><h2>idlelib<a class="headerlink" href="#module-idlelib" title="Permalink to this heading">¶</a></h2> -<p><strong>Source code:</strong> <a class="reference external" href="https://github.com/python/cpython/tree/main/Lib/idlelib";>Lib/idlelib</a></p> +<span id="idlelib-implementation-of-idle-application"></span><h2>idlelib — implementation of IDLE application<a class="headerlink" href="#module-idlelib" title="Link to this heading">¶</a></h2> +<p><strong>Source code:</strong> <a class="extlink-source reference external" href="https://github.com/python/cpython/tree/main/Lib/idlelib";>Lib/idlelib</a></p> <hr class="docutils" /> <p>The Lib/idlelib package implements the IDLE application. See the rest of this page for how to use IDLE.</p> @@ -1031,12 +1031,12 @@ <h3>Extensions<a class="headerlink" href="#extensions" title="Permalink to this </div> </div> </div> - <div class="sphinxsidebar" role="navigation" aria-label="main navigation"> + <div class="sphinxsidebar" role="navigation" aria-label="Main"> <div class="sphinxsidebarwrapper"> <div> <h3><a href="../contents.html">Table of Contents</a></h3> <ul> -<li><a class="reference internal" href="#">IDLE</a><ul> +<li><a class="reference internal" href="#">IDLE — Python editor and shell</a><ul> <li><a class="reference internal" href="#menus">Menus</a><ul> <li><a class="reference internal" href="#file-menu-shell-and-editor">File menu (Shell and Editor)</a></li> <li><a class="reference internal" href="#edit-menu-shell-and-editor">Edit menu (Shell and Editor)</a></li> @@ -1078,7 +1078,7 @@ <h3><a href="../contents.html">Table of Contents</a></h3> <li><a class="reference internal" href="#extensions">Extensions</a></li> </ul> </li> -<li><a class="reference internal" href="#module-idlelib">idlelib</a></li> +<li><a class="reference internal" href="#module-idlelib">idlelib — implementation of IDLE application</a></li> </ul> </li> </ul> @@ -1113,7 +1113,7 @@ <h3>This Page</h3> </div> <div class="clearer"></div> </div> - <div class="related" role="navigation" aria-label="related navigation"> + <div class="related" role="navigation" aria-label="Related"> <h3>Navigation</h3> <ul> <li class="right" style="margin-right: 10px"> @@ -1139,12 +1139,12 @@ <h3>Navigation</h3> </li> <li id="cpython-language-and-version"> - <a href="../index.html">3.14.0a0 Documentation</a> » + <a href="../index.html">3.14.0a4 Documentation</a> » </li> <li class="nav-item nav-item-1"><a href="index.html" >The Python Standard Library</a> »</li> <li class="nav-item nav-item-2"><a href="tk.html" >Graphical User Interfaces with Tk</a> »</li> - <li class="nav-item nav-item-this"><a href="">IDLE</a></li> + <li class="nav-item nav-item-this"><a href="">IDLE — Python editor and shell</a></li> <li class="right"> @@ -1169,7 +1169,7 @@ <h3>Navigation</h3> </ul> </div> <div class="footer"> - © <a href="../copyright.html">Copyright</a> 2001-2024, Python Software Foundation. + © <a href="../copyright.html">Copyright</a> 2001 Python Software Foundation. <br /> This page is licensed under the Python Software Foundation License Version 2. <br /> @@ -1183,11 +1183,11 @@ <h3>Navigation</h3> <br /> <br /> - Last updated on Oct 14, 2024 (20:27 UTC). + Last updated on Feb 07, 2025 (05:56 UTC). <a href="/bugs.html">Found a bug</a>? <br /> - Created using <a href="https://www.sphinx-doc.org/";>Sphinx</a> 7.0.1. + Created using <a href="https://www.sphinx-doc.org/";>Sphinx</a> 8.1.3. </div> </body> diff --git a/Lib/idlelib/help.py b/Lib/idlelib/help.py index d8613b2eadd6aa..4beb2b0d14f8f8 100644 --- a/Lib/idlelib/help.py +++ b/Lib/idlelib/help.py @@ -155,7 +155,9 @@ def handle_data(self, data): d = data if self.pre else data.replace('\n', ' ') if self.tags == 'h1': try: - self.hprefix = d[0:d.index(' ')] + self.hprefix = d[:d.index(' ')] + if not self.hprefix.isdigit(): + self.hprefix = '' except ValueError: self.hprefix = '' if self.tags in ['h1', 'h2', 'h3']: diff --git a/Lib/idlelib/idle_test/test_help.py b/Lib/idlelib/idle_test/test_help.py index c528d4e77f8ca7..ebb02b5c0d8356 100644 --- a/Lib/idlelib/idle_test/test_help.py +++ b/Lib/idlelib/idle_test/test_help.py @@ -29,7 +29,7 @@ def test_1window(self): def test_4text(self): text = self.window.frame.text - self.assertEqual(text.get('1.0', '1.end'), ' IDLE ') + self.assertEqual(text.get('1.0', '1.end'), ' IDLE — Python editor and shell ') if __name__ == '__main__': _______________________________________________ Python-checkins mailing list -- [email protected] To unsubscribe send an email to [email protected] https://mail.python.org/mailman3/lists/python-checkins.python.org/ Member address: [email protected]
