>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
lmpx.com only provides a reader for public news (NNTP) servers. It is not
affiliated with the servers or forums shown here and is not responsible for
the content of articles, which is written by their respective authors.