libxslt @1.1.34_2: man xsltproc gives corrupted (uncompiled?) man page

[JDLH (Jim DeLaHunt)]

The man page for xsltproc is corrupted, perhaps uncompiled, or compiled for the wrong target.

Steps to reproduce:

1. % man xsltproc

Observed behaviour:

XSLTPROC(1)                                        xsltproc Manual                                        XSLTPROC(1)

NAME
       xsltproc - command line XSLT processor

SYNOPSIS
            .HP 216u

                 xsltproc            [                 [                      | -V                      | --version
                      ]                 [                      | -v                      | --verbose                ]
                       [                      {                           | -o                           | --output
                           }                      {                           | FILE                           |
       DIRECTORY                     }                ]                 | --timing                 | --repeat
                       | --debug                 | --novalid                 | --noout                 |
       --maxdepth VALUE                 | --html                 | --encoding ENCODING                  |
       --param PARAMNAME PARAMVALUE                  | --stringparam PARAMNAME PARAMVALUE                  | --nonet
                       | --path "PATH(S)"                 | --load-trace                 | --catalogs
       | --xinclude                 | [ | --profile | --norman ]                 | --dumpextensions                 |
       --nowrite                 | --nomkdir                 | --writesubtree PATH                 | --nodtdattr
                 ]            [STYLESHEET]            {                 | XML-FILE...                  | -
                 }

DESCRIPTION
                  .PP xsltproc is a command line tool for applying XSLT stylesheets to XML documents. It is part of
       libxslt(3), the XSLT C library for GNOME. While it was developed as part of the GNOME project, it can operate
       independently of the GNOME desktop.

…[rest of man page elided]…

Problems: the spacing is wrong. Directives like .HP 216u and .PP are present in the output.

Expected behaviour: a properly formatted man page.

[ryandesign (Ryan Carsten Schmidt)]

Confirmed. The problem is not specific to the universal variant. I think we had a similar problem at some point before, don't remember what port though. I wonder if I can find that...

[ryandesign (Ryan Carsten Schmidt)]

It was #56354.

[JDLH (Jim DeLaHunt)]

Your memory is phenomenal! Thank you, Ryan!

[ryandesign (Ryan Carsten Schmidt)]

Well it was a memorable problem. And now I'd be very interested to know why we're having it again when I thought I fixed it years ago. I will try to investigate tomorrow.

[ryandesign (Ryan Carsten Schmidt)]

Or I'll investigate now. Thankfully it's nothing we did: The developers of libxslt made ​the same mistake in 1.1.34 that we made a couple years ago, mapping the old SourceForge docbook XSL URL to the wrong new CDN URL. See ​https://gitlab.gnome.org/GNOME/libxslt/-/issues/31. They fixed it by switching back to the old URL but haven't released a new version. We can apply a patch for that in the mean time.

[ryandesign (Ryan Carsten Schmidt)]

In 0199be3abe8e94653e4ba33e60927ea787194d7a/macports-ports (master):

libxslt: Fix formatting of xsltproc.1 manpage

Closes: #61779

[ryandesign (Ryan Carsten Schmidt)]

That worked locally but failed to make a difference on the build system. I see it failed to regenerate xsltproc.1 on the build system but ignored that error. I need to fix whatever's preventing it from regenerating it, and delete the old xsltproc.1 beforehand so that a failure to regenerate it is not ignored.

[ryandesign (Ryan Carsten Schmidt)]

In 165a2a94ba99a175394b2b28b54e06980be4d3c2/macports-ports (master):

libxslt: Really fix formatting of xsltproc.1

Closes: #61779

[ryandesign (Ryan Carsten Schmidt)]

In b2dad106386c8e1b972d91be9c823cded0cba167/macports-ports (master):

libxslt: Revert 165a2a9

This still doesn't work on the buildbot for some reason.

See: #61779

[ryandesign (Ryan Carsten Schmidt)]

Good grief. In addition to still not regenerating the manpage on current systems, on older systems it said:

dyld: Symbol not found: _xsltMaxVars
  Referenced from: /opt/local/var/macports/build/_opt_bblocal_var_buildworker_ports_build_ports_textproc_libxslt/libxslt/work/libxslt-1.1.34/doc/./../xsltproc/xsltproc
  Expected in: /usr/lib/libxslt.1.dylib

That would be fixed by setting DYLD_LIBRARY_PATH but I don't know right now why it doesn't want to regenerate on newer systems.

[ryandesign (Ryan Carsten Schmidt)]

In de7c2311c240477502e86ceda594e004b86c6e74/macports-ports (master):

libxslt: Really really fix xsltproc.1

This time using DYLD_LIBRARY_PATH.

Closes: #61779

[ryandesign (Ryan Carsten Schmidt)]

In 9b8466a1e803ba38f860ee008cdb4413e0e8843d/macports-ports (master):

libxslt: Fix build failure on 10.10 and earlier

Just patch the manpage. Forget about trying to regenerate it.

See: #61779