Bug 728459

Summary: openssh: formatting errors in various manpages
Product: Red Hat Enterprise Linux 6 Reporter: Miroslav Vadkerti <mvadkert>
Component: opensshAssignee: Jan F. Chadima <jchadima>
Status: CLOSED ERRATA QA Contact: BaseOS QE Security Team <qe-baseos-security>
Severity: medium Docs Contact:
Priority: medium    
Version: 6.1CC: pvrabec
Target Milestone: rc   
Target Release: ---   
Hardware: All   
OS: Linux   
Whiteboard:
Fixed In Version: Doc Type: Bug Fix
Doc Text:
Story Points: ---
Clone Of: Environment:
Last Closed: 2011-12-06 09:56:18 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:

Description Miroslav Vadkerti 2011-08-05 08:21:05 UTC 
Description of problem:
Various Manual pages contain formatting errors:

1. slogin
:: [   PASS   ] :: Running 'cat /usr/share/man/man1/slogin.1.gz | gunzip | groff -m mdoc > /dev/null 2> /tmp/tmp.HX7Z3AyUif'
mdoc error: .It without preceding .Bl (#1255)
:: [   FAIL   ] :: File '/tmp/tmp.HX7Z3AyUif' should not contain '.*' 

2. ssh-agent
:: [   PASS   ] :: Running 'cat /usr/share/man/man1/ssh-agent.1.gz | gunzip | groff -m mdoc > /dev/null 2> /tmp/tmp.HX7Z3AyUif'
mdoc warning: list open at EOF!  A .Bl directive has no matching .El
:: [   FAIL   ] :: File '/tmp/tmp.HX7Z3AyUif' should not contain '.*' 

3. ssh-copy-id
:: [   PASS   ] :: Running 'cat /usr/share/man/man1/ssh-copy-id.1.gz | gunzip | groff -m mdoc > /dev/null 2> /tmp/tmp.HX7Z3AyUif'
Not a \-mdoc command: .SH (#20)
Not a \-mdoc command: .SH (#22)
Not a \-mdoc command: .SH (#26)
Not a \-mdoc command: .PP (#31)
Not a \-mdoc command: .PP (#41)
Not a \-mdoc command: .PP (#49)
Not a \-mdoc command: .PP (#51)
Not a \-mdoc command: .PP (#53)
mdoc warning: Empty input line #63
Not a \-mdoc command: .SH (#64)
:: [   FAIL   ] :: File '/tmp/tmp.HX7Z3AyUif' should not contain '.*' 

4. ssh
:: [   PASS   ] :: Running 'cat /usr/share/man/man1/ssh.1.gz | gunzip | groff -m mdoc > /dev/null 2> /tmp/tmp.HX7Z3AyUif'
mdoc error: .It without preceding .Bl (#1255)
:: [   FAIL   ] :: File '/tmp/tmp.HX7Z3AyUif' should not contain '.*' 

5. ssh-keygen
:: [   PASS   ] :: Running 'cat /usr/share/man/man1/ssh-keygen.1.gz | gunzip | groff -m mdoc > /dev/null 2> /tmp/tmp.HX7Z3AyUif'
mdoc warning: list open at EOF!  A .Bl directive has no matching .El
:: [   FAIL   ] :: File '/tmp/tmp.HX7Z3AyUif' should not contain '.*' 

6. ssh-keysign
:: [   PASS   ] :: Running 'cat /usr/share/man/man8/ssh-keysign.8.gz | gunzip | groff -m mdoc > /dev/null 2> /tmp/tmp.HX7Z3AyUif'
mdoc warning: list open at EOF!  A .Bl directive has no matching .El
:: [   FAIL   ] :: File '/tmp/tmp.HX7Z3AyUif' should not contain '.*' 

7. sshd
:: [   PASS   ] :: Running 'cat /usr/share/man/man8/sshd.8.gz | gunzip | groff -m mdoc > /dev/null 2> /tmp/tmp.HX7Z3AyUif'
mdoc warning: list open at EOF!  A .Bl directive has no matching .El
:: [   FAIL   ] :: File '/tmp/tmp.HX7Z3AyUif' should not contain '.*'

Repro steps:
1. Use groff -m mdoc to chech ungzipped man page files

Actual:
There are errors and warnings

Expected:
No errors and warnings
Comment 1 Miroslav Vadkerti 2011-08-05 08:21:38 UTC 
This is an easy fix and developer is willing to fix it
Comment 4 errata-xmlrpc 2011-12-06 09:56:18 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-2011-1551.html