Bug 705397

Summary: openssh: formatting errors in openssh-ldap manpages
Product: Red Hat Enterprise Linux 6 Reporter: Tomas Hoger <thoger>
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: mvadkert, pvrabec
Target Milestone: rc   
Target Release: ---   
Hardware: All   
OS: Linux   
Whiteboard:
Fixed In Version: openssh-5.3p1-54.el6 Doc Type: Bug Fix
Doc Text:
Story Points: ---
Clone Of: Environment:
Last Closed: 2011-12-06 09:56:05 UTC Type: ---
Regression: --- Mount Type: ---
Documentation: --- CRM:
Verified Versions: Category: ---
oVirt Team: --- RHEL 7.3 requirements from Atomic Host:
Cloudforms Team: --- Target Upstream Version:
Attachments:
Description Flags
Prepared opatch solving the problem none

Description Tomas Hoger 2011-05-17 15:19:12 UTC 
Description of problem:
Manual pages in newly introduced openssh-ldap subpackage contain formatting errors that cause man to report errors / warnings when viewing them.  No problems are reported by EL6 man, but F14 man reports the following:

$ man ./ssh-ldap-helper.8.gz > /dev/null
mdoc warning: Empty input line #69
mdoc warning: A .Bl directive has no matching .El (#70)

$ man ./ssh-ldap.conf.5.gz > /dev/null
mdoc error: .It without preceding .Bl (#44)
mdoc error: .It without preceding .Bl (#66)
mdoc error: .It without preceding .Bl (#70)
mdoc error: .It without preceding .Bl (#74)
mdoc error: .It without preceding .Bl (#78)
mdoc error: .It without preceding .Bl (#80)
mdoc error: .It without preceding .Bl (#91)
mdoc error: .It without preceding .Bl (#98)
mdoc error: .It without preceding .Bl (#119)
mdoc error: .It without preceding .Bl (#145)
mdoc error: .It without preceding .Bl (#152)
mdoc error: .It without preceding .Bl (#155)
mdoc error: .It without preceding .Bl (#159)
mdoc error: .It without preceding .Bl (#162)
mdoc error: .It without preceding .Bl (#165)
mdoc error: .It without preceding .Bl (#168)
mdoc error: .It without preceding .Bl (#189)
mdoc error: .It without preceding .Bl (#192)
<standard input>:211: warning: macro `Dqstart_tls' not defined (possibly missing space after `Dq')
mdoc error: .It without preceding .Bl (#222)
mdoc error: .It without preceding .Bl (#240)
mdoc error: .It without preceding .Bl (#257)
mdoc error: .It without preceding .Bl (#305)
mdoc error: .It without preceding .Bl (#308)
mdoc error: .It without preceding .Bl (#312)
mdoc error: .It without preceding .Bl (#315)
mdoc error: .It without preceding .Bl (#323)
mdoc error: .It without preceding .Bl (#330)
mdoc error: .It without preceding .Bl (#333)
mdoc error: .It without preceding .Bl (#336)
mdoc error: .It without preceding .Bl (#339)
mdoc error: .It without preceding .Bl (#346)
mdoc error: .It without preceding .Bl (#351)
mdoc error: .It without preceding .Bl (#354)
mdoc error: .It without preceding .Bl (#357)
mdoc warning: A .Bl directive has no matching .El (#365)

The ssh-ldap.conf.5 errors make that manual page rather unusable, as no configuration keywords are displayed and the man page displays as e.g.:

  Specifies the default base Distinguished Name (DN) to use when performing
  ldap operations.  The base must be specified as a DN in LDAP format.  There
  is no default.
  Specifies the default BIND DN to use when connecting to the ldap server.
  The bind DN must be specified as a Distinguished Name in LDAP format.
  There is no default.
  Specifies the default password to use when connecting to the ldap server
  via BindDN.  There is no default.
  Intentionaly does nothing. Recognized for compatibility reasons.

Version-Release number of selected component (if applicable):
openssh-ldap-5.3p1-52.el6
Comment 1 Jan F. Chadima 2011-05-24 17:19:45 UTC 
Created attachment 500663 [details]
Prepared opatch solving the problem

Adding the patch solving the problem
Comment 3 Miroslav Vadkerti 2011-08-03 12:22:25 UTC 
Just for note the above errors are printed by the groff package when run with -m mdoc paramteter.
Comment 7 errata-xmlrpc 2011-12-06 09:56:05 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