From a3d8e03937b6f91444404e6419fa41a22e79fe2a Mon Sep 17 00:00:00 2001 From: Neiland85 Date: Sun, 21 Jun 2026 09:25:58 +0200 Subject: [PATCH 1/3] Docs: list additional documentation make targets --- Doc/README.rst | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/Doc/README.rst b/Doc/README.rst index 2d1148753e0c6b..4040366bdca183 100644 --- a/Doc/README.rst +++ b/Doc/README.rst @@ -79,6 +79,8 @@ Available make targets are: * "text", which builds a plain text file for each source file. +* "texinfo", which builds Texinfo source files. + * "epub", which builds an EPUB document, suitable to be viewed on e-book readers. @@ -97,6 +99,10 @@ Available make targets are: plain text documentation for the labels defined in ``tools/pyspecific.py`` -- pydoc needs these to show topic and keyword help. +* "doctest", which runs doctests in the documentation. + +* "gettext", which generates gettext message catalog templates. + * "check", which checks for frequent markup errors. * "dist", (Unix only) which creates distributable archives of HTML, text, From 1dbc188aff140592747f0e12e135e89bee92c350 Mon Sep 17 00:00:00 2001 From: Neiland85 Date: Wed, 16 Sep 2026 21:49:40 +0200 Subject: [PATCH 2/3] Docs: document linklint --- Doc/README.rst | 2 ++ 1 file changed, 2 insertions(+) diff --git a/Doc/README.rst b/Doc/README.rst index 4040366bdca183..f91c9506733eec 100644 --- a/Doc/README.rst +++ b/Doc/README.rst @@ -87,6 +87,8 @@ Available make targets are: * "linkcheck", which checks all external references to see whether they are broken, redirected or malformed, and outputs this information to stdout as well as a plain-text (.txt) file. +* "linklint", which removes needless links from the documentation during the + Sphinx build. * "changes", which builds an overview over all versionadded/versionchanged/ deprecated items in the current version. This is meant as a help for the From 73d1e77e22a0c330b35595a8177e486f2b83067b Mon Sep 17 00:00:00 2001 From: Neil Munoz Date: Sat, 26 Sep 2026 08:17:24 +0200 Subject: [PATCH 3/3] Docs: list sphinx-linklint with the other PyPI tools --- Doc/README.rst | 3 +-- 1 file changed, 1 insertion(+), 2 deletions(-) diff --git a/Doc/README.rst b/Doc/README.rst index f91c9506733eec..1ebfbf14d2ec54 100644 --- a/Doc/README.rst +++ b/Doc/README.rst @@ -21,6 +21,7 @@ tree but are maintained separately and are available from * `Sphinx `_ * `blurb `_ * `python-docs-theme `_ +* `sphinx-linklint `_ The easiest way to install these tools is to create a virtual environment and install the tools into there. @@ -87,8 +88,6 @@ Available make targets are: * "linkcheck", which checks all external references to see whether they are broken, redirected or malformed, and outputs this information to stdout as well as a plain-text (.txt) file. -* "linklint", which removes needless links from the documentation during the - Sphinx build. * "changes", which builds an overview over all versionadded/versionchanged/ deprecated items in the current version. This is meant as a help for the