From 51369d11cf170db83d6f28b9954d6300e6eb6913 Mon Sep 17 00:00:00 2001 From: sobolevn Date: Mon, 24 Feb 2025 10:55:59 +0300 Subject: [PATCH] gh-130160: Convert `webbrowser` docs to use `.. option` directive --- Doc/library/webbrowser.rst | 15 ++++++++++++--- 1 file changed, 12 insertions(+), 3 deletions(-) diff --git a/Doc/library/webbrowser.rst b/Doc/library/webbrowser.rst index 2d19c514ce43b6..11544230e89d23 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 page ("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"