reuse-tool: Build and install man pages

[Michael Baeuerle <micha%NetBSD.org@localhost>]

Module Name:	pkgsrc-wip
Committed By:	Michael Baeuerle <micha%NetBSD.org@localhost>
Pushed By:	micha
Date:		Wed Oct 2 18:10:58 2024 +0200
Changeset:	f3e2b428ebd4245cd12d8af3a27220e7155cb1a8

Modified Files:
	reuse-tool/Makefile
	reuse-tool/PLIST
	reuse-tool/distinfo
Added Files:
	reuse-tool/TODO
	reuse-tool/patches/patch-docs_conf.py

Log Message:
reuse-tool: Build and install man pages

To see a diff of this commit:
https://wip.pkgsrc.org/cgi-bin/gitweb.cgi?p=pkgsrc-wip.git;a=commitdiff;h=f3e2b428ebd4245cd12d8af3a27220e7155cb1a8

Please note that diffs are not public domain; they are subject to the
copyright notices on the relevant files.

diffstat:
 reuse-tool/Makefile                   | 16 ++++++++++++++++
 reuse-tool/PLIST                      |  7 +++++++
 reuse-tool/TODO                       |  1 +
 reuse-tool/distinfo                   |  1 +
 reuse-tool/patches/patch-docs_conf.py | 22 ++++++++++++++++++++++
 5 files changed, 47 insertions(+)

diffs:
diff --git a/reuse-tool/Makefile b/reuse-tool/Makefile
index 6a00839cf9..f0ce535848 100644
--- a/reuse-tool/Makefile
+++ b/reuse-tool/Makefile
@@ -13,7 +13,11 @@ LICENSE=	apache-2.0 AND gnu-gpl-v3 AND cc-by-sa-v4.0 AND cc0-1.0-universal
 
 USE_LANGUAGES=	# none
 
+TOOL_DEPENDS+=	${PYPKGPREFIX}-myst-parser>=3.0.1:../../textproc/py-myst-parser
+TOOL_DEPENDS+=	${PYPKGPREFIX}-pbr>=6.0.0:../../devel/py-pbr
 TOOL_DEPENDS+=	${PYPKGPREFIX}-poetry-core>=1.9.0:../../devel/py-poetry-core
+TOOL_DEPENDS+=	${PYPKGPREFIX}-sphinx>=7.3.7:../../textproc/py-sphinx
+TOOL_DEPENDS+=	${PYPKGPREFIX}-sphinxcontrib-apidoc>=0.5.0:../../wip/py-sphinxcontrib-apidoc
 DEPENDS+=	${PYPKGPREFIX}-attrs>=21.3:../../devel/py-attrs
 DEPENDS+=	${PYPKGPREFIX}-binaryornot>=0.4.4:../../devel/py-binaryornot
 DEPENDS+=	${PYPKGPREFIX}-debian>=0.1.34<0.1.45:../../wip/py-debian
@@ -22,5 +26,17 @@ DEPENDS+=	${PYPKGPREFIX}-license-expression>=1.0:../../devel/py-license-expressi
 DEPENDS+=	${PYPKGPREFIX}-jinja2>=3.0.0:../../textproc/py-jinja2
 DEPENDS+=	${PYPKGPREFIX}-tomlkit>=0.8:../../textproc/py-tomlkit
 
+INSTALLATION_DIRS+=	${PKGMANDIR}/man1
+
+post-build:
+	cd ${WRKSRC}/docs && env ${MAKE_ENV} sphinx-build-${PYVERSSUFFIX} -b man "." "_build"
+
+post-install:
+	for manpage in \
+		reuse reuse-annotate reuse-convert-dep5 reuse-download reuse-lint reuse-spdx reuse-supported-licenses ; \
+	do \
+		${INSTALL_MAN} ${WRKSRC}/docs/_build/$${manpage}.1 ${DESTDIR}${PREFIX}/${PKGMANDIR}/man1/ ; \
+	done
+
 .include "../../lang/python/wheel.mk"
 .include "../../mk/bsd.pkg.mk"
diff --git a/reuse-tool/PLIST b/reuse-tool/PLIST
index 0ea2d7bb15..b045cbb3a4 100644
--- a/reuse-tool/PLIST
+++ b/reuse-tool/PLIST
@@ -83,3 +83,10 @@ ${PYSITELIB}/reuse/templates/default_template.jinja2.license
 ${PYSITELIB}/reuse/vcs.py
 ${PYSITELIB}/reuse/vcs.pyc
 ${PYSITELIB}/reuse/vcs.pyo
+man/man1/reuse-annotate.1
+man/man1/reuse-convert-dep5.1
+man/man1/reuse-download.1
+man/man1/reuse-lint.1
+man/man1/reuse-spdx.1
+man/man1/reuse-supported-licenses.1
+man/man1/reuse.1
diff --git a/reuse-tool/TODO b/reuse-tool/TODO
new file mode 100644
index 0000000000..06ca434bb9
--- /dev/null
+++ b/reuse-tool/TODO
@@ -0,0 +1 @@
+- Build is not reproducible yet
diff --git a/reuse-tool/distinfo b/reuse-tool/distinfo
index 9922592f7b..2770dc5448 100644
--- a/reuse-tool/distinfo
+++ b/reuse-tool/distinfo
@@ -3,3 +3,4 @@ $NetBSD$
 BLAKE2s (reuse-tool-4.0.3.tar.gz) = 387c6737cd9098d5f6074247260c745b08acc881464c9fe188284c3356401185
 SHA512 (reuse-tool-4.0.3.tar.gz) = 2f9dca807a0f3eed9356c1fcbe9f7bc8fd9711ac3583811decf90bbb28818a0af64925fa31ee84e8c0e8241d64e9194209b03cb422bf1aeb6b160eca3289bec6
 Size (reuse-tool-4.0.3.tar.gz) = 360402 bytes
+SHA1 (patch-docs_conf.py) = 2296913e40af6f528e2bc1f9f989daa53280cf66
diff --git a/reuse-tool/patches/patch-docs_conf.py b/reuse-tool/patches/patch-docs_conf.py
new file mode 100644
index 0000000000..bcce8bce45
--- /dev/null
+++ b/reuse-tool/patches/patch-docs_conf.py
@@ -0,0 +1,22 @@
+$NetBSD$
+
+Disable "intersphinx_mapping" (wants do fetch stuff from network).
+pkgsrc-wip package for py-furo is broken (not required for building man pages).
+
+--- docs/conf.py.orig	2024-07-08 11:58:05.000000000 +0000
++++ docs/conf.py
+@@ -69,12 +69,12 @@ apidoc_extra_args = ["--maxdepth", "2"]
+ 
+ autodoc_member_order = "bysource"
+ 
+-intersphinx_mapping = {"python": ("https://docs.python.org/3";, None)}
++#intersphinx_mapping = {"python": ("https://docs.python.org/3";, None)}
+ 
+ # -- Options for HTML output -------------------------------------------------
+ # https://www.sphinx-doc.org/en/master/usage/configuration.html#options-for-html-output
+ 
+-html_theme = "furo"
++#html_theme = "furo"
+ html_logo = "reuse-r-only.svg"
+ html_static_path = ["_static"]
+