NetBSD Problem Report #59864

From www@netbsd.org  Fri Dec 26 19:27:15 2025
Return-Path: <www@netbsd.org>
Received: from mail.netbsd.org (mail.netbsd.org [199.233.217.200])
	(using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)
	 key-exchange X25519 server-signature RSA-PSS (2048 bits) server-digest SHA256
	 client-signature RSA-PSS (2048 bits) client-digest SHA256)
	(Client CN "mail.NetBSD.org", Issuer "mail.NetBSD.org CA" (not verified))
	by mollari.NetBSD.org (Postfix) with ESMTPS id 667B51A923C
	for <gnats-bugs@gnats.NetBSD.org>; Fri, 26 Dec 2025 19:27:15 +0000 (UTC)
Message-Id: <20251226192714.159551A923D@mollari.NetBSD.org>
Date: Fri, 26 Dec 2025 19:27:14 +0000 (UTC)
From: mike.volokhov@gmail.com
Reply-To: mike.volokhov@gmail.com
To: gnats-bugs@NetBSD.org
Subject: fonts/harfbuzz: Documentation build fails due to missing docbook-xsl and XML catalog
X-Send-Pr-Version: www-1.0

>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
>Last-Modified:  Wed Jan 07 02:10:01 +0000 2026
>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

>Audit-Trail:
From: Thomas Klausner <wiz@netbsd.org>
To: NetBSD bugtracking <gnats-bugs@netbsd.org>
Cc: 
Subject: Re: pkg/59864: fonts/harfbuzz: Documentation build fails due to
 missing docbook-xsl and XML catalog
Date: Fri, 26 Dec 2025 21:07:56 +0100

 The build with the doc option works fine for me on NetBSD
 11.99.4/x86_64 with pkgsrc as-is.

 The doc option is on by default, and harfbuzz also built fine in a
 Darwin bulk build a couple days ago:

 https://releng.netbsd.org/bulktracker/pkg/75094673

 docbook-xsl is required by gtk-doc, so it should already be installed.

 This looks like a local problem, though I have no idea what might make
 it break this way.
  Thomas

From: Mike Volokhov <mike.volokhov@gmail.com>
To: gnats-bugs@netbsd.org
Cc: pkg-manager@netbsd.org,
 gnats-admin@netbsd.org,
 pkgsrc-bugs@netbsd.org
Subject: Re: pkg/59864: fonts/harfbuzz: Documentation build fails due to
 missing docbook-xsl and XML catalog
Date: Wed, 7 Jan 2026 04:05:46 +0200

 Hi!

 Well, it's hard to tell. The difference is at least in the Darwin
 and pkgsrc versions. I've recently updated it to pkgsrc-2025Q4 and
 did very fresh bootstrap, but the issue remains in the place.

 IMHO it is not a local environment issue, but rather that the pkgsrc
 xsltproc binary does not load the system XML catalog by default (should
 it tho?).

 The gtk-doc is correctly configured to use the pkgsrc binary:

 $ grep xslt /opt/pkg/share/gtk-doc/python/gtkdoc/config_data.py
 xsltproc = '/opt/pkg/bin/xsltproc'

 When running that binary with verbose output, it shows it does not
 load the catalog automatically:

 $ echo "<doc/>" | /opt/pkg/bin/xsltproc -v - 2>&1 | grep catalog
 (no output, error code 1)

 Because xsltproc is blind to the local catalog, it attempts to fetch
 the stylesheets from sourceforge.net <http://sourceforge.net/> and fails.

 My proposed "fix" works because explicitly exporting XML_CATALOG_FILES
 forces xsltproc to look in the right place, bypassing the network check.

 Since gtk-doc relies on xsltproc, harfbuzz (and potentially other
 packages using gtk-doc) should probably ensure XML_CATALOG_FILES is
 set in the MAKE_ENV to prevent this network dependency. Or xsltproc
 should be enforced to the default catalog at /opt/pkg/etc/xml/catalog.

 --
 Mishka

Home	PR Database Search