https://github.com/python/cpython/commit/92d80c60678d6d9057333c767b35c6d3f2870173
commit: 92d80c60678d6d9057333c767b35c6d3f2870173
branch: 3.13
author: Terry Jan Reedy <[email protected]>
committer: terryjreedy <[email protected]>
date: 2026-01-12T22:58:30-05:00
summary:

[3.13] gh-139707: Copy-strip change to idle.rst into idlelib (#143767)

Copy net new text in idle.rst from main to 3.13.
Make 3.13 docs and copy-strip idle.html to idlelib/help.html.
See https://github.com/python/cpython/issues/139707#issuecomment-3737374788
and PR #143718 message for more.

* Revert url to 'main' from '3.13'

The branch in the source links in the revised help.html
become '3.13' instead of 'main' because the html
was generated from an edited 3.13 version of idle.rst
instead being backported from main.  This reversion
avoids the possibility of future backport merge conflicts.

The version makes no difference to the Help/IDLE doc display as
the url is currently neither displayed nor linked to the link title
-- 'Lib/idlelib'.  If we do make the links live, we can use
sys.version_info to replace 'main' when main is no longer the source branch.

files:
M Doc/library/idle.rst
M Lib/idlelib/help.html

diff --git a/Doc/library/idle.rst b/Doc/library/idle.rst
index 9e87704c286252..8249eeb15ccea9 100644
--- a/Doc/library/idle.rst
+++ b/Doc/library/idle.rst
@@ -37,6 +37,11 @@ IDLE has the following features:
 
 * configuration, browsers, and other dialogs
 
+The IDLE application is implemented in the :mod:`idlelib` package.
+
+This is an optional module. If it is missing from your copy of CPython, look 
for documentation from your distributor (that is, whoever provided Python to 
you).
+If you are the distributor, see Requirements for optional modules.
+
 Menus
 -----
 
diff --git a/Lib/idlelib/help.html b/Lib/idlelib/help.html
index fc618ab727d1fb..822ee99479c9dd 100644
--- a/Lib/idlelib/help.html
+++ b/Lib/idlelib/help.html
@@ -16,6 +16,9 @@
 of global and local namespaces</p></li>
 <li><p>configuration, browsers, and other dialogs</p></li>
 </ul>
+<p>The IDLE application is implemented in the <a class="reference internal" 
href="#module-idlelib" title="idlelib: Implementation package for the IDLE 
shell/editor."><code class="xref py py-mod docutils literal notranslate"><span 
class="pre">idlelib</span></code></a> package.</p>
+<p>This is an optional module. If it is missing from your copy of CPython, 
look for documentation from your distributor (that is, whoever provided Python 
to you).
+If you are the distributor, see Requirements for optional modules.</p>
 <section id="menus">
 <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
@@ -516,7 +519,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="Link to this heading">¶</a></h3>
+<span id="idlelib-cli"></span><h3>Command-line usage<a class="headerlink" 
href="#command-line-usage" title="Link to this heading">¶</a></h3>
 <p>IDLE can be invoked from the command line with various options. The general 
syntax is:</p>
 <div class="highlight-bash notranslate"><div 
class="highlight"><pre><span></span>python<span class="w"> </span>-m<span 
class="w"> </span>idlelib<span class="w"> </span><span 
class="o">[</span>options<span class="o">]</span><span class="w"> </span><span 
class="o">[</span>file<span class="w"> </span>...<span class="o">]</span>
 </pre></div>

_______________________________________________
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]

Reply via email to