https://github.com/python/cpython/commit/cc6b62ac561e857a2cc4eb4f43e1e0e9f53c09f1
commit: cc6b62ac561e857a2cc4eb4f43e1e0e9f53c09f1
branch: main
author: Semyon Moroz <[email protected]>
committer: hugovk <[email protected]>
date: 2025-11-17T14:51:21Z
summary:
gh-130160: Add anchors to CLI Usage section for `cmdline` (#133182)
files:
M Doc/library/cmdline.rst
M Doc/library/ensurepip.rst
M Doc/library/gzip.rst
M Doc/library/idle.rst
M Doc/library/inspect.rst
M Doc/library/pdb.rst
M Doc/library/site.rst
M Doc/library/webbrowser.rst
diff --git a/Doc/library/cmdline.rst b/Doc/library/cmdline.rst
index 16c67ddbf7cec2..c43b10157f9aea 100644
--- a/Doc/library/cmdline.rst
+++ b/Doc/library/cmdline.rst
@@ -16,17 +16,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 <json-commandline>`
* :ref:`mimetypes <mimetypes-cli>`
-* :mod:`pdb`
+* :ref:`pdb <pdb-cli>`
* :ref:`pickle <pickle-cli>`
* :ref:`pickletools <pickletools-cli>`
* :ref:`platform <platform-cli>`
@@ -52,8 +52,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 165b9a9f823154..32b92c01570004 100644
--- a/Doc/library/ensurepip.rst
+++ b/Doc/library/ensurepip.rst
@@ -42,7 +42,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 cb36be42a83f12..d23c0741ddbecd 100644
--- a/Doc/library/gzip.rst
+++ b/Doc/library/gzip.rst
@@ -283,7 +283,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
@@ -296,7 +296,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 52e3726a0f5af5..a16f46ef812400 100644
--- a/Doc/library/idle.rst
+++ b/Doc/library/idle.rst
@@ -661,7 +661,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 13a352cbdb2cdc..c00db31a8ec051 100644
--- a/Doc/library/inspect.rst
+++ b/Doc/library/inspect.rst
@@ -1788,7 +1788,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 90dc6648045f27..0bbdc42535290a 100644
--- a/Doc/library/pdb.rst
+++ b/Doc/library/pdb.rst
@@ -76,6 +76,10 @@ The debugger's prompt is ``(Pdb)``, which is the indicator
that you are in debug
.. _pdb-cli:
+
+Command-line interface
+----------------------
+
.. program:: pdb
You can also invoke :mod:`pdb` from the command line to debug other scripts.
For
@@ -334,7 +338,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 e98dd83b60eb60..d93e4dc7c75f1a 100644
--- a/Doc/library/site.rst
+++ b/Doc/library/site.rst
@@ -270,7 +270,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 fd6abc70261019..a2103d8fdd8efe 100644
--- a/Doc/library/webbrowser.rst
+++ b/Doc/library/webbrowser.rst
@@ -49,6 +49,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
@@ -232,7 +237,7 @@ Here are some simple examples::
.. _browser-controllers:
-Browser Controller Objects
+Browser controller objects
--------------------------
Browser controllers provide the :attr:`~controller.name` attribute,
_______________________________________________
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]
