qemu-guest-agent: New doc option.

[Taylor R Campbell (via pkgsrc-wip) <commit-notify%pkgsrc.org@localhost>]

Module Name:	pkgsrc-wip
Committed By:	Taylor R Campbell <riastradh%NetBSD.org@localhost>
Pushed By:	riastradh
Date:		Mon Mar 10 17:54:08 2025 +0000
Changeset:	9ca378bc7b41bc4dc8354e1589aacda59f537e55

Modified Files:
	qemu-guest-agent/Makefile
	qemu-guest-agent/PLIST
Added Files:
	qemu-guest-agent/options.mk

Log Message:
qemu-guest-agent: New doc option.

Avoids pulling in the whole python sphinx toolchain just for one
little tool.

No functional change intended unless you specify
PLIST_OPTIONS.qemu-guest-agent+= -doc.

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

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

diffstat:
 qemu-guest-agent/Makefile   | 21 ++++++++++-----------
 qemu-guest-agent/PLIST      |  4 ++--
 qemu-guest-agent/options.mk | 18 ++++++++++++++++++
 3 files changed, 30 insertions(+), 13 deletions(-)

diffs:
diff --git a/qemu-guest-agent/Makefile b/qemu-guest-agent/Makefile
index 87a62ffbc3..54859dca91 100644
--- a/qemu-guest-agent/Makefile
+++ b/qemu-guest-agent/Makefile
@@ -13,8 +13,6 @@ LICENSE=	gnu-gpl-v2 AND gnu-lgpl-v2.1 AND mit AND modified-bsd
 
 TOOL_DEPENDS+=	meson-[0-9]*:../../devel/meson
 TOOL_DEPENDS+=	ninja-build-[0-9]*:../../devel/ninja-build
-TOOL_DEPENDS+=	${PYPKGPREFIX}-sphinx-[0-9]*:../../textproc/py-sphinx
-TOOL_DEPENDS+=	${PYPKGPREFIX}-sphinx-rtd-theme>=1.2.0:../../textproc/py-sphinx-rtd-theme
 
 PYTHON_VERSIONS_INCOMPATIBLE=	39 310 # py-sphinx
 
@@ -30,6 +28,8 @@ RCD_SCRIPTS=		qemu-guest-agent
 # https://github.com/qemu/qemu/commit/56208a0d473c6db263cc333c787ca48b502d72ab
 GCC_REQD+=		7
 
+.include "options.mk"
+
 .include "../../mk/bsd.prefs.mk"
 
 CONFIGURE_ARGS+=	--prefix=${PREFIX}
@@ -50,7 +50,6 @@ CONFIGURE_ARGS+=	--disable-bzip2
 CONFIGURE_ARGS+=	--disable-cap-ng
 CONFIGURE_ARGS+=	--disable-coroutine-pool
 CONFIGURE_ARGS+=	--disable-curses
-#CONFIGURE_ARGS+=	--disable-docs
 CONFIGURE_ARGS+=	--disable-fdt
 CONFIGURE_ARGS+=	--disable-gcrypt
 CONFIGURE_ARGS+=	--disable-glusterfs
@@ -89,14 +88,14 @@ do-install:
 	cd ${WRKSRC} && ${SETENV} ${MAKE_ENV} ${INSTALL_ENV} \
 		ninja -j ${_MAKE_JOBS_N:U1} -C build install
 	# not needed for guest agent
-	${RM} -r ${DESTDIR}${PREFIX}/include/qemu-plugin.h
-	${RM} -r ${DESTDIR}${PREFIX}/${PKGMANDIR}/man1/qemu.1
-	${RM} -r ${DESTDIR}${PREFIX}/${PKGMANDIR}/man7/qemu-block-drivers.7
-	${RM} -r ${DESTDIR}${PREFIX}/${PKGMANDIR}/man7/qemu-cpu-models.7
-	${RM} -r ${DESTDIR}${PREFIX}/${PKGMANDIR}/man7/qemu-qmp-ref.7
-	${RM} -r ${DESTDIR}${PREFIX}/share/doc/qemu
-	${RM} -r ${DESTDIR}${PREFIX}/share/qemu/keymaps
-	${RM} -r ${DESTDIR}${PREFIX}/share/qemu/trace-events-all
+	${RM} -f ${DESTDIR}${PREFIX}/include/qemu-plugin.h
+	${RM} -f ${DESTDIR}${PREFIX}/${PKGMANDIR}/man1/qemu.1
+	${RM} -f ${DESTDIR}${PREFIX}/${PKGMANDIR}/man7/qemu-block-drivers.7
+	${RM} -f ${DESTDIR}${PREFIX}/${PKGMANDIR}/man7/qemu-cpu-models.7
+	${RM} -f ${DESTDIR}${PREFIX}/${PKGMANDIR}/man7/qemu-qmp-ref.7
+	${RM} -rf ${DESTDIR}${PREFIX}/share/doc/qemu
+	${RM} -rf ${DESTDIR}${PREFIX}/share/qemu/keymaps
+	${RM} -rf ${DESTDIR}${PREFIX}/share/qemu/trace-events-all
 
 # Some dependencies aren't correct and this tries to be re-made on install,
 # failing due to configure bugs.
diff --git a/qemu-guest-agent/PLIST b/qemu-guest-agent/PLIST
index 4745c04d03..bd8cca8990 100644
--- a/qemu-guest-agent/PLIST
+++ b/qemu-guest-agent/PLIST
@@ -1,4 +1,4 @@
 @comment $NetBSD$
 bin/qemu-ga
-man/man7/qemu-ga-ref.7
-man/man8/qemu-ga.8
+${PLIST.doc}man/man7/qemu-ga-ref.7
+${PLIST.doc}man/man8/qemu-ga.8
diff --git a/qemu-guest-agent/options.mk b/qemu-guest-agent/options.mk
new file mode 100644
index 0000000000..7287469c29
--- /dev/null
+++ b/qemu-guest-agent/options.mk
@@ -0,0 +1,18 @@
+#	$NetBSD$
+
+PKG_OPTIONS_VAR=	PKG_OPTIONS.qemu-guest-agent
+PKG_SUPPORTED_OPTIONS+=	doc
+PKG_SUGGESTED_OPTIONS+=	doc
+
+PLIST_VARS+=		doc
+
+.include "../../mk/bsd.options.mk"
+
+.if ${PKG_OPTIONS:Mdoc}
+PLIST.doc=		yes
+CONFIGURE_ARGS+=	--enable-docs
+TOOL_DEPENDS+=		${PYPKGPREFIX}-sphinx-[0-9]*:../../textproc/py-sphinx
+TOOL_DEPENDS+=		${PYPKGPREFIX}-sphinx-rtd-theme>=1.2.0:../../textproc/py-sphinx-rtd-theme
+.else
+CONFIGURE_ARGS+=	--disable-docs
+.endif