Initial PoC for packaging with manpages

CHANGES.rst

@@ -54,6 +54,8 @@ Features added
 
   Patch by Adam Turner.
 
+* #12528: Add manpages to the sdist and wheels, so pipx and pip can install them.
+  Patch by Fredrik Mellström.
 * #12258: Support ``typing_extensions.Unpack``
   Patch by Bénédikt Tran and Adam Turner.
 

Makefile

@@ -70,8 +70,12 @@ test:
 covertest:
 	@$(PYTHON) -X dev -X warn_default_encoding -m pytest -v --cov=sphinx --junitxml=.junit.xml $(TEST)
 
+.PHONY: manpages
+manpages:
+	tox run -e manpages
+
 .PHONY: build
-build:
+build: manpages
 	@$(PYTHON) -m build .
 
 .PHONY: docs

pyproject.toml

@@ -113,6 +113,9 @@ sphinx-autogen = "sphinx.ext.autosummary.generate:main"
 [tool.flit.module]
 name = "sphinx"
 
+[tool.flit.external-data]
+directory = "data"
+
 [tool.flit.sdist]
 include = [
     "LICENSE.rst",

tox.ini

@@ -60,6 +60,16 @@ deps =
 commands =
     sphinx-autobuild ./doc ./build/sphinx/
 
+[testenv:manpages]
+description =
+    Build manpages.
+extras =
+    docs
+commands =
+    python -c "import shutil; shutil.rmtree('./data/share/man', ignore_errors=True) if '{env:CLEAN:}' else None"
+    sphinx-build -M man -d "{envtmpdir}{/}doctree" ./doc ./data/share/man/man1 --color
+    python -c 'from pathlib import Path; Path("./data/share/man/man1/sphinx-all.1").unlink(missing_ok=True)'
+
 [testenv:bindep]
 description =
     Install binary dependencies.