Bug 1397186 - The manual page for "dig" doesn't format properly
Summary: The manual page for "dig" doesn't format properly
Keywords:
Status: CLOSED ERRATA
Alias: None
Product: Fedora
Classification: Fedora
Component: bind
Version: 25
Hardware: Unspecified
OS: Unspecified
unspecified
unspecified
Target Milestone: ---
Assignee: Petr Menšík
QA Contact: Fedora Extras Quality Assurance
URL:
Whiteboard:
: 1398547 1401892 1412162 1413395 (view as bug list)
Depends On: 1400526
Blocks:
TreeView+ depends on / blocked
 
Reported: 2016-11-21 20:14 UTC by Göran Uddeborg
Modified: 2017-01-17 19:53 UTC (History)
11 users (show)

Fixed In Version: bind-9.10.4-4.P5.fc25
Doc Type: If docs needed, set a value
Doc Text:
Clone Of:
Environment:
Last Closed: 2017-01-17 19:53:01 UTC
Type: Bug


Attachments (Terms of Use)

Description Göran Uddeborg 2016-11-21 20:14:50 UTC
Description of problem:
When doing "man dig" I see a page where the roff directives show, and the formatting is broken.


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


How reproducible:
Every time


Steps to Reproduce:
1. man dig


Actual results:
A page that starts:

  .SH "NAME" dig - DNS lookup utility
  .SH "SYNOPSIS"
    .HP 4


Expected results:
A page starting like this:

NAME
      dig - DNS lookup utility

SYNOPSIS
      dig [@server] ...

(With the headers in boldface.)


Additional info:
Looking at the source in /usr/share/man/man1/dig.1.gz all the roff directives are indented.  That wasn't legal formatting in the time I wrote this kind of documents.  It seems it is still not legal.

The other manual pages in bind-utils look good.  This problem only happens for "dig".

Comment 1 Martin Sehnoutka 2016-11-25 08:51:43 UTC
*** Bug 1398547 has been marked as a duplicate of this bug. ***

Comment 2 Petr Menšík 2016-12-06 19:33:58 UTC
Reported as ISC-Bugs #43831 upstream. The bug is related to https://sourceforge.net/p/docbook/bugs/1381/

Temporary workaround is before compilation:
find . -name '*.docbook' -exec sed -e 's,xmlns="http://docbook.org/ns/docbook",xmlns:db="http://docbook.org/ns/docbook",' -i '{}' ';'

Waiting for upstream for response.

Comment 3 Petr Menšík 2016-12-12 18:12:16 UTC
*** Bug 1401892 has been marked as a duplicate of this bug. ***

Comment 4 Petr Menšík 2016-12-12 18:16:47 UTC
Upstream docs are fixed by https://source.isc.org/cgi-bin/gitweb.cgi?p=bind9.git;a=commit;h=1b8ce3b3302f0afe682d04df8a1f20b4ac346fb2
When I backport docs change to Fedora 25 and Rawhide, man page(s) would be fine again.

Comment 5 Petr Menšík 2017-01-16 11:14:32 UTC
*** Bug 1412162 has been marked as a duplicate of this bug. ***

Comment 6 Petr Menšík 2017-01-16 11:14:59 UTC
*** Bug 1413395 has been marked as a duplicate of this bug. ***

Comment 7 Lukas Slebodnik 2017-01-16 12:20:14 UTC
Is there a reason why this patch was not backported with recent update bind-9.10.4-3.P5 ? (or 9.11.0-4.P2 in rawhide)

Comment 8 Fedora Update System 2017-01-16 15:16:14 UTC
bind-9.10.4-4.P5.fc25 has been submitted as an update to Fedora 25. https://bodhi.fedoraproject.org/updates/FEDORA-2017-553c7f2c39

Comment 9 Fedora Update System 2017-01-16 22:24:30 UTC
bind-9.10.4-4.P5.fc25 has been pushed to the Fedora 25 testing repository. If problems still persist, please make note of it in this bug report.
See https://fedoraproject.org/wiki/QA:Updates_Testing for
instructions on how to install test updates.
You can provide feedback for this update here: https://bodhi.fedoraproject.org/updates/FEDORA-2017-553c7f2c39

Comment 10 Fedora Update System 2017-01-17 19:53:01 UTC
bind-9.10.4-4.P5.fc25 has been pushed to the Fedora 25 stable repository. If problems still persist, please make note of it in this bug report.


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