Red Hat Bugzilla – Bug 502121
Macro issue with: man 8 isdnctrl_conf
Last modified: 2013-04-12 16:16:44 EDT
Description of problem:
"man 8 isdnctrl_conf" is an unusual manpage;
"gunzip -c /usr/share/man/man8/isdnctrl_conf.8.gz|less" shows the manpage to contain valid-looking troff macros, but the format looks nothing like any of the other manpages on the system: no heading, NAME, SYNOPSIS, DESCRIPTION etc.
The macros don't seem to be properly handled, and the textual content from them is not appearing when rendered by "man".
For example, unzipped the file shows this clause:
.SS Syntax of the configuration file
This syntax will be used for the options
But this is rendered by "man" as:
"This syntax will be used for the options and"
i.e. the "readconf" and "writeconf" macro args are being dropped
Version-Release number of selected component (if applicable):
100%; minor issue
Steps to Reproduce:
1. gunzip -c /usr/share/man/man8/isdnctrl_conf.8.gz
2. man 8 isdnctrl_conf
Textual content from step 1 appears in step 2, but the macros don't appear to be doing anything useful in step 2. Doesn't look like a regular manpage. Much content being dropped from "man" output (see above)
(Found testing an automated manpage checker, testing all of manpages in RHEL 5.3)
This request was evaluated by Red Hat Engineering for inclusion in a Red
Hat Enterprise Linux maintenance release.
Red Hat does not currently plan to provide this change in a Red Hat Enterprise
Linux update release for currently deployed products.
With the goal of minimizing risk of change for deployed systems, and in
response to customer and partner requirements, Red Hat takes a conservative
approach when evaluating enhancements for inclusion in maintenance updates
for currently deployed products. The primary objectives of update releases
are to enable new hardware platform support and to resolve critical
However, Red Hat will further review this request for potential inclusion
in future major releases of Red Hat Enterprise Linux.