Bug 639866

Summary:	docbook2man generates man pages which rpmlint does not like
Product:	Red Hat Enterprise Linux 6	Reporter:	Ondrej Vasik <ovasik>
Component:	docbook-utils	Assignee:	Ondrej Vasik <ovasik>
Status:	CLOSED ERRATA	QA Contact:	Filip Holec <fholec>
Severity:	medium	Docs Contact:
Priority:	low
Version:	6.1	CC:	fholec, mschmidt, ovasik, psplicha, syeghiay
Target Milestone:	rc
Target Release:	---
Hardware:	All
OS:	Linux
Whiteboard:
Fixed In Version:	docbook-utils-0.6.14-25.el6	Doc Type:	Bug Fix
Doc Text:	Cause: Perl script used for generating manpages contained one typo. Consequence: Bad syntax of all manpages built docbook-utils. Even though this typo was in header, so it had no impact on the content, the manpages had invalid syntax. Fix: Perl script was fixed. Result: Manpages built by this new docbook-utils package will have correct manpage header syntax.	Story Points:	---
Clone Of:	639347	Environment:
Last Closed:	2012-10-02 10:08:53 UTC	Type:	---
Regression:	---	Mount Type:	---
Documentation:	---	CRM:
Verified Versions:		Category:	---
oVirt Team:	---	RHEL 7.3 requirements from Atomic Host:
Cloudforms Team:	---	Target Upstream Version:
Embargoed:
Bug Depends On:	639347
Bug Blocks:	836169

Description Ondrej Vasik 2010-10-04 09:00:18 UTC

+++ This bug was initially created as a clone of Bug #639347 +++

Created attachment 451023 [details]
zif.sgml - the source for a manpage

Description of problem:
rpmlint complained about the manpage generated by docbook2man in this package review: https://bugzilla.redhat.com/show_bug.cgi?id=631763#c6

The warning was:
manual-page-warning /usr/share/man/man1/zif.1.gz 1: warning: `\"' not defined

The warning can be reproduced using a command like this:
gtbl < zif.1 | groff -mtty-char -Tutf8 -P-c -mandoc -mandoc -wmac >/dev/null
(where zif.1 was generated by docbook2man from the attached source)

groff does not like the first line in the file:
.\\" auto-generated by docbook2man-spec $Revision: 1.2 $

I believe the correct form would be:
.\" auto-generated by docbook2man-spec $Revision: 1.2 $

Version-Release number of selected component (if applicable):
docbook-utils-0.6.14-23.fc13.noarch

How reproducible:
always

Steps to Reproduce:
1. generate a manpage from the attached source using docbook2man
2. verify it using the command mentioned above (that's basically what rpmlint uses)
  
Actual results:
a warning is produced

Expected results:
no warnings

Comment 1 Suzanne Logcher 2011-02-15 21:43:29 UTC

This issue was proposed for RHEL 6.1 FasTrack but did not get resolved in time.
It has been moved to RHEL 6.2 FasTrack.

Comment 12 errata-xmlrpc 2012-10-02 10:08:53 UTC

Since the problem described in this bug report should be
resolved in a recent advisory, it has been closed with a
resolution of ERRATA.

For information on the advisory, and where to find the updated
files, follow the link below.

If the solution does not work for you, open a new bug report.

http://rhn.redhat.com/errata/RHBA-2012-1321.html