| Summary: | nss-pam-ldapd: troff syntax error in the man page of nslcd | ||||||
|---|---|---|---|---|---|---|---|
| Product: | Red Hat Enterprise Linux 6 | Reporter: | Subin Francis <sfrancis> | ||||
| Component: | man-pages-overrides | Assignee: | Ivana Varekova <varekova> | ||||
| Status: | CLOSED NOTABUG | QA Contact: | BaseOS QE - Apps <qe-baseos-apps> | ||||
| Severity: | medium | Docs Contact: | |||||
| Priority: | medium | ||||||
| Version: | 6.0 | CC: | arthur, nalin, ovasik, rpiddapa, syeghiay | ||||
| Target Milestone: | rc | Keywords: | ManPageChange | ||||
| Target Release: | 6.1 | ||||||
| Hardware: | All | ||||||
| OS: | Linux | ||||||
| Whiteboard: | |||||||
| Fixed In Version: | Doc Type: | Bug Fix | |||||
| Doc Text: | Story Points: | --- | |||||
| Clone Of: | |||||||
| : | 692496 (view as bug list) | Environment: | |||||
| Last Closed: | 2011-04-18 12:26:30 UTC | Type: | --- | ||||
| Regression: | --- | Mount Type: | --- | ||||
| Documentation: | --- | CRM: | |||||
| Verified Versions: | Category: | --- | |||||
| oVirt Team: | --- | RHEL 7.3 requirements from Atomic Host: | |||||
| Cloudforms Team: | --- | Target Upstream Version: | |||||
| Bug Depends On: | |||||||
| Bug Blocks: | 692496 | ||||||
| Attachments: |
|
||||||
The manual page is a part of nss-pam-ldapd package. The nslcd manual page is generated from docbook XML (using docbook2x-man) in the source tarball. It should fall back to the included troff files built as part of the release if docbook2x-man isn't available. The troff files included in the tarball work correctly on Debian. We don't list docbook2x-man as a build-time requirement, so it turns out that we're not actually rebuilding the man page. The man command appears to be tripping up on the first line in the file ('\" -*- coding: utf-8 -*-). When I run Fedora's db2x_docbook2man command on the .xml file, I get something similar, but that initial single quote turns into a period (.\" -*- coding: us-ascii -*-), which 'man' seems to handle better.
The package containing that command isn't in RHEL, though, so we can't do that. The man-db package, which replaces man in recent Fedora releases, also handles both versions of the file without problems, so in future releases this isn't an issue. So I guess the simplest thing is to patch that character from the tarball's man page when we compile for 6.x.
Created attachment 479603 [details]
patch for build-time
This affects nslcd.conf(5) as well. However we work around this, we should make sure we get both. The man page is already fixed in 692496, now this bug is removed from man-pages-overrides errata. I'm closing this bug (notabug). |
Description of problem: With RHEL6.0 GA, I am getting "Error parsing *roff command from file /usr/share/man/man8/nslcd.8.gz" in the man page of nslcd Version-Release number of selected component (if applicable): RHEL 6.0 How reproducible: Just run "man nslcd |& head" from shell. Actual results: ------------ Error parsing *roff command from file /usr/share/man/man8/nslcd.8.gz nslcd(8) System Manager’s Manual nslcd(8) NAME nslcd - local LDAP name service daemon. SYNOPSIS nslcd [ options ] ------------ Expected results: It should not throw any troff syntax error.