pkg/59864: fonts/harfbuzz: Documentation build fails due to missing docbook-xsl and XML catalog

[mike.volokhov%gmail.com@localhost]

>Number:         59864
>Category:       pkg
>Synopsis:       fonts/harfbuzz: Documentation build fails due to missing docbook-xsl and XML catalog
>Confidential:   no
>Severity:       serious
>Priority:       medium
>Responsible:    pkg-manager
>State:          open
>Class:          sw-bug
>Submitter-Id:   net
>Arrival-Date:   Fri Dec 26 19:30:01 +0000 2025
>Originator:     Mike Volokhov
>Release:        pkgsrc-2025Q3
>Organization:
>Environment:
Darwin Fourteen.local 24.1.0 Darwin Kernel Version 24.1.0: Thu Oct 10 21:03:15 PDT 2024; root:xnu-11215.41.3~2/RELEASE_ARM64_T6000 arm64
>Description:
Hi! When building fonts/harfbuzz with the "doc" option enabled (PKG_OPTIONS.harfbuzz+= doc), the build fails during the gtk-doc generation phase. The OS is macOS 15.1.1.

The failure occurs because the build environment lacks a dependency on textproc/docbook-xsl, and the build tools (xsltproc) are not informed of the local XML catalog location. Consequently, the build attempts to fetch stylesheets from SourceForge (http://docbook.sourceforge.net/...), which fails or is blocked in the sandbox, leading to the following error:


ERROR: Error in gtkdoc helper script:

ERROR: ['/opt/pkg/bin/gtkdoc-mkhtml', '--path=/Users/mishka/pkgsrc/fonts/harfbuzz/work/harfbuzz-11.4.5/docs:/Users/mishka/pkgsrc/fonts/harfbuzz/work/harfbuzz-11.4.5/output/docs', 'harfbuzz', '../harfbuzz-docs.xml'] failed with status 5
warning: failed to load external entity "http://docbook.sourceforge.net/release/xsl/current/html/chunk.xsl";
compilation error: file /opt/pkg/share/gtk-doc/data/gtk-doc.xsl line 11 element import
xsl:import : unable to load http://docbook.sourceforge.net/release/xsl/current/html/chunk.xsl
>How-To-Repeat:
1. Ensure "PKG_OPTIONS.harfbuzz+= doc" is set
2. cd fonts/harfbuzz && make install  # the failure at the install phase
3. Observe failure in the doc generation step

>Fix:
The following patch to options.mk recovers the install:

Index: options.mk
===================================================================
RCS file: /cvsroot/pkgsrc/fonts/harfbuzz/options.mk,v
retrieving revision 1.18
diff -u -r1.18 options.mk
--- options.mk	20 May 2024 21:21:38 -0000	1.18
+++ options.mk	26 Dec 2025 19:25:04 -0000
@@ -14,6 +14,8 @@
 .if !empty(PKG_OPTIONS:Mdoc)
 MESON_ARGS+=		-Ddocs=enabled
 TOOL_DEPENDS+=		gtk-doc>=1.32nb9:../../textproc/gtk-doc
+BUILD_DEPENDS+=		docbook-xsl-[0-9]*:../../textproc/docbook-xsl
+MAKE_ENV+=		XML_CATALOG_FILES=${PREFIX}/etc/xml/catalog
 PLIST.doc=		yes
 .else
 MESON_ARGS+=		-Ddocs=disabled