Bug 1064756

Summary: bwrap.1 manpage formatting is broken
Product: [openSUSE] openSUSE Tumbleweed Reporter: Clark Boylan <clark.boylan>
Component: ContainersAssignee: Containers Team <containers-bugowner>
Status: RESOLVED DUPLICATE QA Contact: E-mail List <qa-bugs>
Severity: Minor    
Priority: P5 - None CC: bengan
Version: Current   
Target Milestone: ---   
Hardware: x86-64   
OS: Other   
Whiteboard:
Found By: --- Services Priority:
Business Priority: Blocker: ---
Marketing QA Status: --- IT Deployment: ---

Description Clark Boylan 2017-10-23 21:53:57 UTC
User-Agent:       Mozilla/5.0 (X11; Linux x86_64; rv:55.0) Gecko/20100101 Firefox/55.0
Build Identifier: 

The bubblewrap package ships a manpage for the bwrap command with broken formatting. There are roff macros like .PP in the output. Looking at the file directly this appears to be due to leading whitespace before the roff macros.

Reproducible: Always

Steps to Reproduce:
1. zypper install bubblewrap
2. man bwrap

Actual Results:  
         .PP When options are used multiple times, the last option wins, unless otherwise specified.

         .PP General options:

           .PP --help

                 Print help and exit

               .RE
               .PP --version

                     Print version


Expected Results:  
       When options are used multiple times, the last option wins, unless otherwise specified.

       General options:

       --help
           Print help and exit

       --version
           Print version


I've locally built the man page from source and it seems to render fine so I think this may be a packaging bug?
Comment 1 Clark Boylan 2017-10-23 22:12:49 UTC
Digging further this seems potentially related to the docbook stylesheets that ship with tumbleweed. Builds properly with the upstream stylesheet and --nonet removed from the xsltproc command, but the build fails when run against docbook-xsl-stylesheets.
Comment 2 Bengt Gördén 2017-11-03 09:57:40 UTC
This need some attention. It seems to spread. systemd is now cluttered with manpages that has this problem.

man journalctl

JOURNALCTL(1)                                                                    journalctl                                                                    JOURNALCTL(1)

    .SH "NAME" journalctl - Query the systemd journal

    .SH "SYNOPSIS"

      .HP 264u
Comment 3 Clark Boylan 2017-11-05 23:34:32 UTC
This issue is actively being tracked in bug 1063066 so marking this as duplicate and letting things get tracked there.

*** This bug has been marked as a duplicate of bug 1063066 ***