https://github.com/python/cpython/commit/a63ceb7f10b658c0c55128c8f8b58487b3fb6ea6 commit: a63ceb7f10b658c0c55128c8f8b58487b3fb6ea6 branch: 3.13 author: Semyon Moroz <[email protected]> committer: hugovk <[email protected]> date: 2025-11-17T19:55:54+02:00 summary:
[3.13] gh-130160: Add anchors to CLI Usage section for `cmdline` (GH-133182) (#141667) Co-authored-by: Semyon Moroz <[email protected]> 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 32d23d9ae81282..5eca161e2282aa 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 fa102c4a080103..8feaf8a7dccfe3 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 d6f72c1610c560..597798b4916954 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 10ec7f0a6f14c9..9e87704c286252 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 a6107dea0f938b..df6a9f1d01c5d4 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 b9016c132750ba..8f2981f31082ef 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 95aea779f82673..484c3f8af58389 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 baccc791b227fd..a15c26fa344ef7 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, _______________________________________________ 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]
