Bug 1063934

Summary: Tumbleweed: Manpages corrupted
Product: [openSUSE] openSUSE Tumbleweed Reporter: Forgotten User aABuZXsv-t <forgotten_aABuZXsv-t>
Component: BasesystemAssignee: systemd maintainers <systemd-maintainers>
Status: RESOLVED DUPLICATE QA Contact: E-mail List <qa-bugs>
Severity: Normal    
Priority: P5 - None CC: fbui, pmonrealgonzalez, tchvatal
Version: Current   
Target Milestone: ---   
Hardware: Other   
OS: Other   
Whiteboard:
Found By: --- Services Priority:
Business Priority: Blocker: ---
Marketing QA Status: --- IT Deployment: ---

Description Forgotten User aABuZXsv-t 2017-10-18 00:42:18 UTC
On the latest systemd release (systemd-234-6.1.x86_64) the man pages seem corrupt. The man macros are all visible.
Comment 1 Franck Bui 2017-10-19 08:16:23 UTC
Werner, do you have any idea ? Thanks.
Comment 2 Dr. Werner Fink 2017-10-19 08:58:41 UTC
(In reply to Franck Bui from comment #1)
> Werner, do you have any idea ? Thanks.

Yep, the XML to (N)ROFF converter adds spaces before the roff sequences. There are two types of sequences: the \<macro> type and the .<macro> type.  The last macro type has to start *always* at the beginning of a line (no blanks are allowd).

 zcat /usr/share/man/man1/systemctl.1.gz |\
 sed -r 's/^[[:blank:]]+(\.[a-zA-Z])/\1/' |\
 nroff -mandb | less -MR

... now it is better but there are more blanks (space, tab stops, ) added as well and this does garble the remaining format
Comment 3 Dr. Werner Fink 2017-10-19 09:15:49 UTC
Could be a broken /usr/bin/xsltproc which is part of libxslt-tools ... and/or the man/custom-man.xsl is broken as well
Comment 4 Franck Bui 2017-10-19 09:22:53 UTC
Thanks Werner for the info.

As I understood it, systemd is probably not the only package suffering from this ?
Comment 5 Dr. Werner Fink 2017-10-19 09:25:00 UTC
Just tested it ... it is /usr/bin/xsltproc on tumbleweed ... and all packages using xsltproc are affected (IMHO=
Comment 6 Pedro Monreal Gonzalez 2017-10-19 11:45:48 UTC
Not sure where the problem is. I just updated libxslt to version 1.1.30 (see sr#535190 https://build.opensuse.org/request/show/535190). Could you please check if it solves the issue?
Comment 7 Pedro Monreal Gonzalez 2017-10-19 14:50:48 UTC
(In reply to Dr. Werner Fink from comment #5)
> Just tested it ... it is /usr/bin/xsltproc on tumbleweed ... and all
> packages using xsltproc are affected (IMHO=

Werner, looking at the changelog, there doesn't seem to be any significant change recently. How did you come to the conclusion that all of a sudden libxslt is causing the problem?
Comment 8 Dr. Werner Fink 2017-10-19 15:13:57 UTC
(In reply to Pedro Monreal Gonzalez from comment #7)
> (In reply to Dr. Werner Fink from comment #5)
> > Just tested it ... it is /usr/bin/xsltproc on tumbleweed ... and all
> > packages using xsltproc are affected (IMHO=
> 
> Werner, looking at the changelog, there doesn't seem to be any significant
> change recently. How did you come to the conclusion that all of a sudden
> libxslt is causing the problem?

I've tried the command line

/usr/bin/xsltproc --nonet --xinclude --stringparam man.output.quietly 1 --stringparam funcsynopsis.style ansi --stringparam man.authors.section.enabled 0 --stringparam man.copyright.section.enabled 0 --stringparam systemd.version 234 --path './man:./man' ./man/custom-man.xsl man/journalctl.xml

which worked well on Leap but cause broken journalctl.1 on Tumbleweed ... and as /usr/bin/xsltproc is part of libxslt-tools this is a valid conclusion I guess
Comment 9 Franck Bui 2017-10-23 07:38:14 UTC
Ok it was already reported so let's mark this one as a duplicate of bug 1063066

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