From: Miss Islington (bot) <31488909+miss-islington@users.noreply.github.com>
Date: Sun, 9 Mar 2025 07:03:56 +0000 (+0100)
Subject: [3.13] gh-130160: use `.. program::` directive for documenting `webbrowser` CLI ... 
X-Git-Tag: v3.13.3~152
X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;h=d50941c1c3665a7c639fbae59c66ca2511a26183;p=thirdparty%2FPython%2Fcpython.git

[3.13] gh-130160: use `.. program::` directive for documenting `webbrowser` CLI (GH-130995) (#131003)

gh-130160: use `.. program::` directive for documenting `webbrowser` CLI (GH-130995)

use `.. program::` directive for documenting `webbrowser` CLI
(cherry picked from commit 92e5f826ace1eab29920a0a3487a3cac7eeab925)

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

diff --git a/Doc/library/webbrowser.rst b/Doc/library/webbrowser.rst
index 2d19c514ce43..d33e7344761f 100644
--- a/Doc/library/webbrowser.rst
+++ b/Doc/library/webbrowser.rst
@@ -40,14 +40,23 @@ 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.
 
+.. program:: webbrowser
+
 The script :program:`webbrowser` can be used as a command-line interface for the
 module. It accepts a URL as the argument. It accepts the following optional
 parameters:
 
-* ``-n``/``--new-window`` opens the URL in a new browser window, if possible.
-* ``-t``/``--new-tab`` opens the URL in a new browser page ("tab").
+.. option:: -n, --new-window
+
+   Opens the URL in a new browser window, if possible.
+
+.. option:: -t, --new-tab
+
+   Opens the URL in a new browser tab.
+
+The options are, naturally, mutually exclusive.  Usage example:
 
-The options are, naturally, mutually exclusive.  Usage example::
+.. code-block:: bash
 
    python -m webbrowser -t "https://www.python.org"