Merge branch 'pypa:main' into main

Author: dukecat0

noxfile.py

@@ -43,6 +43,7 @@ def build(session, autobuild=False):
         "-b", "html",  # use HTML builder
         "-n",  # nitpicky warn about all missing references
         "-W",  # Treat warnings as errors.
+        *session.posargs,
         "source",  # where the rst files are located
         target_build_dir,  # where to put the html output
     )

source/conf.py

@@ -89,6 +89,8 @@
 # Usually you set "language" from the command line for these cases.
 language = None
 
+locale_dirs = ['../locales']
+
 # making all documents use single text domain
 gettext_compact = "messages"
 

source/specifications/direct-url.rst

@@ -278,18 +278,18 @@ Example pip commands and their effect on direct_url.json
 
 Commands that generate a ``direct_url.json``:
 
-* pip install https://example.com/app-1.0.tgz
-* pip install https://example.com/app-1.0.whl
-* pip install "git+https://example.com/repo/app.git#egg=app&subdirectory=setup"
-* pip install ./app
-* pip install file:///home/user/app
-* pip install --editable "git+https://example.com/repo/app.git#egg=app&subdirectory=setup"
+* ``pip install https://example.com/app-1.0.tgz``
+* ``pip install https://example.com/app-1.0.whl``
+* ``pip install "git+https://example.com/repo/app.git#egg=app&subdirectory=setup"``
+* ``pip install ./app``
+* ``pip install file:///home/user/app``
+* ``pip install --editable "git+https://example.com/repo/app.git#egg=app&subdirectory=setup"``
   (in which case, ``url`` will be the local directory where the git repository has been
   cloned to, and ``dir_info`` will be present with ``"editable": true`` and no
   ``vcs_info`` will be set)
-* pip install -e ./app
+* ``pip install -e ./app``
 
 Commands that *do not* generate a ``direct_url.json``
 
-* pip install app
-* pip install app --no-index --find-links https://example.com/
+* ``pip install app``
+* ``pip install app --no-index --find-links https://example.com/``