From: Semyon Moroz <donbarbos@proton.me>
Date: Mon, 17 Nov 2025 17:55:54 +0000 (+0400)
Subject: [3.13] gh-130160: Add anchors to CLI Usage section for `cmdline` (GH-133182) (#141667)
X-Git-Url: http://git.ipfire.org/?a=commitdiff_plain;h=a63ceb7f10b658c0c55128c8f8b58487b3fb6ea6;p=thirdparty%2FPython%2Fcpython.git

[3.13] gh-130160: Add anchors to CLI Usage section for `cmdline` (GH-133182) (#141667)

Co-authored-by: Semyon Moroz <donbarbos@proton.me>
---

diff --git a/Doc/library/cmdline.rst b/Doc/library/cmdline.rst
index 32d23d9ae812..5eca161e2282 100644
--- a/Doc/library/cmdline.rst
+++ b/Doc/library/cmdline.rst
@@ -15,17 +15,17 @@ The following modules have a command-line interface.
 * :ref:`dis <dis-cli>`
 * :ref:`doctest <doctest-cli>`
 * :mod:`!encodings.rot_13`
-* :mod:`ensurepip`
+* :ref:`ensurepip <ensurepip-cli>`
 * :mod:`filecmp`
 * :mod:`fileinput`
 * :mod:`ftplib`
 * :ref:`gzip <gzip-cli>`
 * :ref:`http.server <http-server-cli>`
-* :mod:`!idlelib`
+* :ref:`idlelib <idlelib-cli>`
 * :ref:`inspect <inspect-module-cli>`
 * :ref:`json.tool <json-commandline>`
 * :mod:`mimetypes`
-* :mod:`pdb`
+* :ref:`pdb <pdb-cli>`
 * :mod:`pickle`
 * :ref:`pickletools <pickletools-cli>`
 * :ref:`platform <platform-cli>`
@@ -51,8 +51,8 @@ The following modules have a command-line interface.
 * :mod:`turtledemo`
 * :ref:`unittest <unittest-command-line-interface>`
 * :ref:`uuid <uuid-cli>`
-* :mod:`venv`
-* :mod:`webbrowser`
+* :ref:`venv <venv-cli>`
+* :ref:`webbrowser <webbrowser-cli>`
 * :ref:`zipapp <zipapp-command-line-interface>`
 * :ref:`zipfile <zipfile-commandline>`
 
diff --git a/Doc/library/ensurepip.rst b/Doc/library/ensurepip.rst
index fa102c4a0801..8feaf8a7dccf 100644
--- a/Doc/library/ensurepip.rst
+++ b/Doc/library/ensurepip.rst
@@ -40,7 +40,9 @@ when creating a virtual environment) or after explicitly uninstalling
 
 .. include:: ../includes/wasm-mobile-notavail.rst
 
-Command line interface
+.. _ensurepip-cli:
+
+Command-line interface
 ----------------------
 
 .. program:: ensurepip
diff --git a/Doc/library/gzip.rst b/Doc/library/gzip.rst
index d6f72c1610c5..597798b49169 100644
--- a/Doc/library/gzip.rst
+++ b/Doc/library/gzip.rst
@@ -262,7 +262,7 @@ Example of how to GZIP compress a binary string::
 
 .. _gzip-cli:
 
-Command Line Interface
+Command-line interface
 ----------------------
 
 The :mod:`gzip` module provides a simple command line interface to compress or
@@ -275,7 +275,7 @@ Once executed the :mod:`gzip` module keeps the input file(s).
    Add a new command line interface with a usage.
    By default, when you will execute the CLI, the default compression level is 6.
 
-Command line options
+Command-line options
 ^^^^^^^^^^^^^^^^^^^^
 
 .. option:: file
diff --git a/Doc/library/idle.rst b/Doc/library/idle.rst
index 10ec7f0a6f14..9e87704c2862 100644
--- a/Doc/library/idle.rst
+++ b/Doc/library/idle.rst
@@ -657,7 +657,9 @@ looked for in the user's home directory.  Statements in this file will be
 executed in the Tk namespace, so this file is not useful for importing
 functions to be used from IDLE's Python shell.
 
-Command line usage
+.. _idlelib-cli:
+
+Command-line usage
 ^^^^^^^^^^^^^^^^^^
 
 .. program:: idle
diff --git a/Doc/library/inspect.rst b/Doc/library/inspect.rst
index a6107dea0f93..df6a9f1d01c5 100644
--- a/Doc/library/inspect.rst
+++ b/Doc/library/inspect.rst
@@ -1740,7 +1740,7 @@ Buffer flags
 
 .. _inspect-module-cli:
 
-Command Line Interface
+Command-line interface
 ----------------------
 
 The :mod:`inspect` module also provides a basic introspection capability
diff --git a/Doc/library/pdb.rst b/Doc/library/pdb.rst
index b9016c132750..8f2981f31082 100644
--- a/Doc/library/pdb.rst
+++ b/Doc/library/pdb.rst
@@ -75,6 +75,11 @@ The debugger's prompt is ``(Pdb)``, which is the indicator that you are in debug
    arguments of the ``p`` command.
 
 
+.. _pdb-cli:
+
+Command-line interface
+----------------------
+
 .. program:: pdb
 
 You can also invoke :mod:`pdb` from the command line to debug other scripts.  For
@@ -248,7 +253,7 @@ access further features, you have to do this yourself:
 
 .. _debugger-commands:
 
-Debugger Commands
+Debugger commands
 -----------------
 
 The commands recognized by the debugger are listed below.  Most commands can be
diff --git a/Doc/library/site.rst b/Doc/library/site.rst
index 95aea779f826..484c3f8af583 100644
--- a/Doc/library/site.rst
+++ b/Doc/library/site.rst
@@ -262,7 +262,7 @@ Module contents
 
 .. _site-commandline:
 
-Command Line Interface
+Command-line interface
 ----------------------
 
 .. program:: site
diff --git a/Doc/library/webbrowser.rst b/Doc/library/webbrowser.rst
index baccc791b227..a15c26fa344e 100644
--- a/Doc/library/webbrowser.rst
+++ b/Doc/library/webbrowser.rst
@@ -40,6 +40,11 @@ a new tab, with the browser being brought to the foreground. The use of the
 :mod:`webbrowser` module on iOS requires the :mod:`ctypes` module. If
 :mod:`ctypes` isn't available, calls to :func:`.open` will fail.
 
+.. _webbrowser-cli:
+
+Command-line interface
+----------------------
+
 .. program:: webbrowser
 
 The script :program:`webbrowser` can be used as a command-line interface for the
@@ -223,7 +228,7 @@ Here are some simple examples::
 
 .. _browser-controllers:
 
-Browser Controller Objects
+Browser controller objects
 --------------------------
 
 Browser controllers provide the :attr:`~controller.name` attribute,