Bug 1135082

Summary: zypper man page formatting broken
Product: [openSUSE] openSUSE Tumbleweed Reporter: Ignaz Forster <iforster>
Component: libzyppAssignee: E-mail List <zypp-maintainers>
Status: VERIFIED FIXED QA Contact: E-mail List <qa-bugs>
Severity: Normal    
Priority: P5 - None CC: coolo, jake.norris, mrueckert, riafarov, Ulrich.Windl
Version: Current   
Target Milestone: ---   
Hardware: Other   
OS: Other   
Whiteboard:
Found By: --- Services Priority:
Business Priority: Blocker: ---
Marketing QA Status: --- IT Deployment: ---
Attachments: zypper manpage code to test

Description Ignaz Forster 2019-05-14 14:47:29 UTC
The zypper man page (`man zypper`) contains several formatting errors: Starting at the description of the "install (in)" command various '+' and occasional '-' signs are spread in the text without any obvious reason.
Later on (starting in the "-t, --type" option of "in") the man page contains whole passages incorrectly printed in bold or underlined.

Looking at the spec file it seems this only happens when the man page was generated using Ruby's asciidoctor, pages created with asciidoc seem to look correct.
Comment 1 Marcus Rückert 2019-05-14 15:17:06 UTC
The owner of the package has never logged in to bugzilla.
Comment 2 Michael Andres 2019-05-16 11:31:14 UTC
> $ osc maintained asciidoc
> openSUSE:Leap:15.0:Update/asciidoc
> openSUSE:Leap:15.1:Update/asciidoc
> openSUSE:Leap:42.3:Update/asciidoc

> $ isc maintained asciidoc 
> SUSE:SLE-11-SP4:Update/asciidoc
> SUSE:SLE-11:Update/asciidoc
> SUSE:SLE-12:Update/asciidoc
> SUSE:SLE-15:Update/asciidoc

> $ osc maintained ruby2.5-rubygem-asciidoctor
> BuildService API error: no packages found by search criteria
> $ isc maintained ruby2.5-rubygem-asciidoctor
> BuildService API error: no packages found by search criteria

@Stefan: A year ago you asked us to move away from asciidoc because it will be dropped and use the ruby stuff. Now asciidoctor is broken and unmaintained while asciidoc seems to be still alive. I guess it's ok if we revert the change and go back to using asciidoc.
Comment 3 Marcus Rückert 2019-05-16 14:59:03 UTC
so it seems for sles coolo is marked as maintainer of it.
Comment 4 Michael Andres 2019-05-16 16:15:46 UTC
Created attachment 805297 [details]
zypper manpage code to test

The tarball contains 
- the manpage source code zypper.8.txt (+includes)
- zypper.8.asciidoc.GOOD correct manpage formated by asciidoc
- zypper.8.asciidoctor.BAD broken manpage formated by asciidoctor
- doc.sh stupid script to create zypper.8.{asciidoc,asciidoctor} out of the source
Comment 5 Stefan Behlert 2019-05-17 08:07:49 UTC
(In reply to Michael Andres from comment #2)
> > $ osc maintained asciidoc
> > openSUSE:Leap:15.0:Update/asciidoc
> > openSUSE:Leap:15.1:Update/asciidoc
> > openSUSE:Leap:42.3:Update/asciidoc
> 
> > $ isc maintained asciidoc 
> > SUSE:SLE-11-SP4:Update/asciidoc
> > SUSE:SLE-11:Update/asciidoc
> > SUSE:SLE-12:Update/asciidoc
> > SUSE:SLE-15:Update/asciidoc
> 
> > $ osc maintained ruby2.5-rubygem-asciidoctor
> > BuildService API error: no packages found by search criteria
> > $ isc maintained ruby2.5-rubygem-asciidoctor
> > BuildService API error: no packages found by search criteria
> 
> @Stefan: A year ago you asked us to move away from asciidoc because it will
> be dropped and use the ruby stuff. Now asciidoctor is broken and
> unmaintained while asciidoc seems to be still alive. I guess it's ok if we
> revert the change and go back to using asciidoc.

We should rather fix aciidoctor....
Comment 6 Michael Andres 2019-10-23 10:21:38 UTC
*** Bug 1154803 has been marked as a duplicate of this bug. ***
Comment 7 Enzo Matsumiya 2020-03-20 17:47:20 UTC
*** Bug 1167122 has been marked as a duplicate of this bug. ***
Comment 8 Michael Andres 2020-04-08 13:58:22 UTC
*** Bug 1168990 has been marked as a duplicate of this bug. ***
Comment 9 Stephan Kulow 2020-04-21 06:19:15 UTC
I won't fix the ruby module - but let's bring back asciidoc
Comment 10 Swamp Workflow Management 2020-04-23 12:40:09 UTC
This is an autogenerated message for OBS integration:
This bug (1135082) was mentioned in
https://build.opensuse.org/request/show/796535 Factory / asciidoc
Comment 11 Stephan Kulow 2020-05-04 11:59:54 UTC
Tumbleweed and 15SP2 got asciidoc using python3 now. So please switch back
Comment 12 Michael Andres 2020-05-04 12:50:33 UTC
zypper-1.14.36 should be well formated again.
Comment 13 Rodion Iafarov 2020-09-30 14:53:50 UTC
Verified in the latest TW and SLES build 48.1. man page is displayed correctly.