Bug 705397 - openssh: formatting errors in openssh-ldap manpages
Summary: openssh: formatting errors in openssh-ldap manpages
Keywords:
Status: CLOSED ERRATA
Alias: None
Product: Red Hat Enterprise Linux 6
Classification: Red Hat
Component: openssh
Version: 6.1
Hardware: All
OS: Linux
medium
medium
Target Milestone: rc
: ---
Assignee: Jan F. Chadima
QA Contact: BaseOS QE Security Team
URL:
Whiteboard:
Depends On:
Blocks:
TreeView+ depends on / blocked
 
Reported: 2011-05-17 15:19 UTC by Tomas Hoger
Modified: 2011-12-06 09:56 UTC (History)
2 users (show)

Fixed In Version: openssh-5.3p1-54.el6
Doc Type: Bug Fix
Doc Text:
Clone Of:
Environment:
Last Closed: 2011-12-06 09:56:05 UTC
Target Upstream Version:


Attachments (Terms of Use)
Prepared opatch solving the problem (1.50 KB, patch)
2011-05-24 17:19 UTC, Jan F. Chadima
no flags Details | Diff


Links
System ID Private Priority Status Summary Last Updated
Red Hat Product Errata RHBA-2011:1551 0 normal SHIPPED_LIVE openssh bug fix and enhancement update 2011-12-06 00:39:25 UTC

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


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