[MacPorts] #56354: xsltproc breaks man pages

MacPorts noreply at macports.org
Wed Apr 25 04:46:59 UTC 2018


#56354: xsltproc breaks man pages
------------------------+---------------------
 Reporter:  mouse07410  |      Owner:  (none)
     Type:  defect      |     Status:  new
 Priority:  Normal      |  Milestone:
Component:  ports       |    Version:
 Keywords:              |       Port:  libxslt
------------------------+---------------------
 MacOS 10.13.4, Xcode-9.3, current Macports and all the installed ports.

 Attempting to generate man pages from XML sources now result in Nroff tags
 being prefixed with one or more tabs. That in turn causes nroff to not
 format these pages properly. I just re-installed {libxslt}, and now its
 own man page is screwed up:

 Output of {{{man xsltproc}}}:
 {{{
 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...
 |
        -           }
 }}}

 Here's what the beginning of {{{/opt/local/share/man/man1/xsltproc.1}}}
 file looks like (observe how {{{.HP}}} tag does **not** begin at the first
 column of the line):
 {{{
 $ gunzip -cd /opt/local/share/man/man1/xsltproc.1.gz | head -50
 '\" t
 .\"     Title: xsltproc
 .\"    Author: John Fleck <jfleck at inkstain.net>
 .\" Generator: DocBook XSL Stylesheets v1.79.2 <http://docbook.sf.net/>
 .\"      Date: $Date$
 .\"    Manual: xsltproc Manual
 .\"    Source: libxslt
 .\"  Language: English
 .\"
 .TH "XSLTPROC" "1" "$Date$" "libxslt" "xsltproc Manual"
 .\" -----------------------------------------------------------------
 .\" * Define some portability stuff
 .\" -----------------------------------------------------------------
 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 .\" http://bugs.debian.org/507673
 .\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 .ie \n(.g .ds Aq \(aq
 .el       .ds Aq '
 .\" -----------------------------------------------------------------
 .\" * set default formatting
 .\" -----------------------------------------------------------------
 .\" disable hyphenation
 .nh
 .\" disable justification (adjust text to left margin only)
 .ad l
 .\" -----------------------------------------------------------------
 .\" * MAIN CONTENT STARTS HERE *
 .\" -----------------------------------------------------------------





 .SH "NAME"
 xsltproc \- command line XSLT processor

 .SH "SYNOPSIS"

         .HP \w'\fBxsltproc\fR\ 'u

                 \fBxsltproc\fR
                  [
                          [
                                  | \fB\-V\fR
                                  | \fB\-\-version\fR
                         ]
                          [
                                  | \fB\-v\fR
                                  | \fB\-\-verbose\fR
 }}}

 In [https://github.com/OpenSC/OpenSC.git] package every tag in every man
 page is messed up this way (prefixed by one or more tabs or spaces, so the
 tag does not start at the beginning of the line, so roff ignores it).

 Attaching the page source and the generated result.

 Help is appreciated. *Yes, I know this port is not maintained.*

-- 
Ticket URL: <https://trac.macports.org/ticket/56354>
MacPorts <https://www.macports.org/>
Ports system for macOS


More information about the macports-tickets mailing list