NetBSD Problem Report #55123
From martin@aprisoft.de Sat Mar 28 18:44:09 2020
Return-Path: <martin@aprisoft.de>
Received: from mail.netbsd.org (mail.netbsd.org [199.233.217.200])
(using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits))
(Client CN "mail.NetBSD.org", Issuer "mail.NetBSD.org CA" (not verified))
by mollari.NetBSD.org (Postfix) with ESMTPS id C08B81A9213
for <gnats-bugs@gnats.NetBSD.org>; Sat, 28 Mar 2020 18:44:08 +0000 (UTC)
Message-Id: <20200328184400.7EDC05CC805@emmas.aprisoft.de>
Date: Sat, 28 Mar 2020 19:44:00 +0100 (CET)
From: martin@NetBSD.org
Reply-To: martin@NetBSD.org
To: gnats-bugs@NetBSD.org
Subject: libxslt's man pages are unreadable
X-Send-Pr-Version: 3.95
>Number: 55123
>Category: pkg
>Synopsis: libxslt's man pages are unreadable
>Confidential: no
>Severity: non-critical
>Priority: low
>Responsible: pkg-manager
>State: closed
>Class: sw-bug
>Submitter-Id: net
>Arrival-Date: Sat Mar 28 18:45:00 +0000 2020
>Closed-Date: Thu Apr 02 06:42:27 +0000 2020
>Last-Modified: Thu Apr 02 06:45:01 +0000 2020
>Originator: Martin Husemann
>Release: NetBSD 9.99.52
>Organization:
The NetBSD Foundation, Inc.
>Environment:
System: NetBSD martins.aprisoft.de 9.99.52 NetBSD 9.99.52 (GENERIC) #83: Fri Mar 27 12:57:00 CET 2020 martin@martins.aprisoft.de:/usr/src/sys/arch/amd64/compile/GENERIC amd64
Architecture: x86_64
Machine: amd64
>Description:
The man pages, like xsltproc(1), installed by libslt are totaly unreadable.
Some preprocessing missing?
>How-To-Repeat:
man xsltproc
>Fix:
n/a
>Release-Note:
>Audit-Trail:
From: Ingo Schwarze <schwarze@usta.de>
To: gnats-bugs@netbsd.org
Cc: Thomas Klausner <tk@giga.or.at>
Subject: Re: pkg/55123: libxslt's man pages are unreadable
Date: Sat, 28 Mar 2020 23:18:56 +0100
As wiz@ observed, the xsltproc(1) manual page contains leading
whitespace, even on macro lines, and large amounts of blank lines.
Both aren't valid roff(7) syntax. In other words, that manual page
is totally broken upstream.
The rule "garbage in - garbage out" applies. Output generated from
that totally broken input is very similar with groff(1) and with
mandoc(1), so this doesn't indicate bugs or missing features in
mandoc or in groff. When installing from the OpenBSD ports tree,
the manual page is totally broken, too, in about the same way, so
this isn't a NetBSD or pkgsrc problem either.
Please report the broken documentation upstream to xmlsoft.org.
In general, it is an extremely bad idea to use any kind of XML for
documentation, and DocBook in particular must be avoided at all
cost. DocBook is notorious for being very fragile, always generating
extremely low quality manual pages, and very often generating output
that is totally unusable and very hard to fix. Tell upstream to
switch to some sane input format for maintaining their documentation
that does *mot* involve XML. The best formats available are, in
decreasing order: 1. mdoc(7), 2. perlpod(1), 3. man(7). Anything
else is quite bad, but DocBook is by far the worst of all options.
Even though DocBook is very frequently broken (i get several reports
about it being broken every year, even though i have nothing to do
with the DocBook project), new ways in which it is broken keep
showing up; i have no idea what the people maintining it are doing.
So when dealing with DocBook stuff, there is no easy solution.
If you want to design a stopgap, you have to look at the individual
case and hand-roll whatever workaround is needed.
One option may be to completely avoid the usual DocBook toolchain
in the NetBSD port and instead convert DocBook to manual pages with:
https://mandoc.bsd.lv/docbook2mdoc/
That may work for some manual pages, but many DocBook features are
not yet implemented in docbook2mdoc, so it may not work (yet) for
others. I have no idea how easy or hard using that program would
be from a porting perspective.
State-Changed-From-To: open->closed
State-Changed-By: wiz@NetBSD.org
State-Changed-When: Thu, 02 Apr 2020 06:42:27 +0000
State-Changed-Why:
Worked around in package.
From: "Thomas Klausner" <wiz@netbsd.org>
To: gnats-bugs@gnats.NetBSD.org
Cc:
Subject: PR/55123 CVS commit: pkgsrc/textproc/libxslt
Date: Thu, 2 Apr 2020 06:42:03 +0000
Module Name: pkgsrc
Committed By: wiz
Date: Thu Apr 2 06:42:02 UTC 2020
Modified Files:
pkgsrc/textproc/libxslt: Makefile
Log Message:
libxslt: fix man page
Addresses PR 55123 with a SUBST_SED.
Bump PKGREVISION.
To generate a diff of this commit:
cvs rdiff -u -r1.110 -r1.111 pkgsrc/textproc/libxslt/Makefile
Please note that diffs are not public domain; they are subject to the
copyright notices on the relevant files.
>Unformatted:
(Contact us)
$NetBSD: query-full-pr,v 1.51 2026/08/10 02:28:17 riastradh Exp $
$NetBSD: gnats_config.sh,v 1.10 2026/05/13 22:00:09 riastradh Exp $
Copyright © 1994-2026
The NetBSD Foundation, Inc. ALL RIGHTS RESERVED.