Bug 1400526 - "dig" man-page layout broken
Summary: "dig" man-page layout broken
Keywords:
Status: CLOSED EOL
Alias: None
Product: Fedora
Classification: Fedora
Component: docbook-style-xsl
Version: 28
Hardware: Unspecified
OS: Linux
unspecified
low
Target Milestone: ---
Assignee: Ondrej Vasik
QA Contact: Fedora Extras Quality Assurance
URL:
Whiteboard:
: 1402410 (view as bug list)
Depends On:
Blocks: 1397186 1401892
TreeView+ depends on / blocked
 
Reported: 2016-12-01 12:31 UTC by Robin Ketelbuters
Modified: 2019-05-28 19:25 UTC (History)
5 users (show)

Fixed In Version:
Doc Type: If docs needed, set a value
Doc Text:
Clone Of:
: 1401892 (view as bug list)
Environment:
Last Closed: 2019-05-28 19:25:54 UTC
Type: Bug


Attachments (Terms of Use)
Screenshot of the broken layout (160.91 KB, image/png)
2016-12-01 12:31 UTC, Robin Ketelbuters
no flags Details
broken "dig" man-page (8.19 KB, application/x-gzip)
2016-12-01 12:39 UTC, Robin Ketelbuters
no flags Details

Description Robin Ketelbuters 2016-12-01 12:31:19 UTC
Created attachment 1226817 [details]
Screenshot of the broken layout

Description of problem:
The layout of manpage "dig(1)" from "bind-utils" is broken.
Please see attachment.

Version-Release number of selected component (if applicable):
bind-utils-32:9.10.4-2.P4.fc25.x86_64

How reproducible:
Attempt to read the "dig" man-page on Fedora 25.

Steps to Reproduce:
1. Install the bind-utils package
# dnf install -y bind-utils

2. Open dig man-page
# man dig

Actual results:
Broken layout

Expected results:
Nice, readable man-page

Additional info:
I tried reinstalling the package, but the problem persists.
The broken file is located at /usr/share/man/man1/dig.1.gz
Viewing this file explicitly with man shows the same result.

Comment 1 Robin Ketelbuters 2016-12-01 12:39:22 UTC
Created attachment 1226818 [details]
broken "dig" man-page

The file in question

Comment 2 Nikola Forró 2016-12-01 13:38:44 UTC
Hi Robin,

thanks for reporting.

dig.1 man page is not part of man-pages package, so this bug should have been filed against bind.

However, the man page is being generated from docbook source using XSL stylesheets from docbook-style-xsl package, and the real problem seems to be there. The man page is fine when generated with docbook-style-xsl-1.78.1-5.fc24  , but garbled with docbook-style-xsl-1.79.1-1.fc25.

Steps to reproduce:

git clone https://source.isc.org/git/bind9.git --depth 1
cd bind9
./configure --with-docbook-xsl=/usr/share/sgml/docbook/xsl-stylesheets
cd bin/dig
make man
man -l dig.1

Comment 3 Robin Ketelbuters 2016-12-01 14:34:52 UTC
Hello Nikola,

You're welcome. Thank you for explaining how man pages are generated!
I'll be sure to remember if I encounter more garbled pages.

Comment 4 Ondrej Vasik 2016-12-03 08:13:14 UTC
Thanks for reassigning. I think https://sourceforge.net/p/docbook/bugs/1381/ describes what happens here. Non-namespace aware docbook is used for processing name-spaced docbook document.

Partially, it can be considered bug in bind - using non-namespaced stylesheets with namespaced their own xsl is bad habbit - so they should probably change the build dependency to docbook5-style-xsl ... bud as bob stated he will fix it in next release of docbook 4 stylesheets, so it can be definitely fixed on the docbook stylesheets side.
Meanwhile, I'd suggest cloning this report against bind-utils - so they can fix the build requires.

Comment 5 Nikola Forró 2016-12-07 13:48:45 UTC
*** Bug 1402410 has been marked as a duplicate of this bug. ***

Comment 6 Fedora End Of Life 2017-11-16 19:35:42 UTC
This message is a reminder that Fedora 25 is nearing its end of life.
Approximately 4 (four) weeks from now Fedora will stop maintaining
and issuing updates for Fedora 25. It is Fedora's policy to close all
bug reports from releases that are no longer maintained. At that time
this bug will be closed as EOL if it remains open with a Fedora  'version'
of '25'.

Package Maintainer: If you wish for this bug to remain open because you
plan to fix it in a currently maintained version, simply change the 'version'
to a later Fedora version.

Thank you for reporting this issue and we are sorry that we were not
able to fix it before Fedora 25 is end of life. If you would still like
to see this bug fixed and are able to reproduce it against a later version
of Fedora, you are encouraged  change the 'version' to a later Fedora
version prior this bug is closed as described in the policy above.

Although we aim to fix as many bugs as possible during every release's
lifetime, sometimes those efforts are overtaken by events. Often a
more recent Fedora release includes newer upstream software that fixes
bugs or makes them obsolete.

Comment 7 Fedora End Of Life 2018-02-20 15:21:34 UTC
This bug appears to have been reported against 'rawhide' during the Fedora 28 development cycle.
Changing version to '28'.

Comment 8 Ben Cotton 2019-05-02 22:08:48 UTC
This message is a reminder that Fedora 28 is nearing its end of life.
On 2019-May-28 Fedora will stop maintaining and issuing updates for
Fedora 28. It is Fedora's policy to close all bug reports from releases
that are no longer maintained. At that time this bug will be closed as
EOL if it remains open with a Fedora 'version' of '28'.

Package Maintainer: If you wish for this bug to remain open because you
plan to fix it in a currently maintained version, simply change the 'version' 
to a later Fedora version.

Thank you for reporting this issue and we are sorry that we were not 
able to fix it before Fedora 28 is end of life. If you would still like 
to see this bug fixed and are able to reproduce it against a later version 
of Fedora, you are encouraged  change the 'version' to a later Fedora 
version prior this bug is closed as described in the policy above.

Although we aim to fix as many bugs as possible during every release's 
lifetime, sometimes those efforts are overtaken by events. Often a 
more recent Fedora release includes newer upstream software that fixes 
bugs or makes them obsolete.

Comment 9 Ben Cotton 2019-05-28 19:25:54 UTC
Fedora 28 changed to end-of-life (EOL) status on 2019-05-28. Fedora 28 is
no longer maintained, which means that it will not receive any further
security or bug fix updates. As a result we are closing this bug.

If you can reproduce this bug against a currently maintained version of
Fedora please feel free to reopen this bug against that version. If you
are unable to reopen this bug, please file a new report against the
current release. If you experience problems, please add a comment to this
bug.

Thank you for reporting this bug and we are sorry it could not be fixed.


Note You need to log in before you can comment on or make changes to this bug.