Bug 502121 - Macro issue with: man 8 isdnctrl_conf
Summary: Macro issue with: man 8 isdnctrl_conf
Keywords:
Status: CLOSED DEFERRED
Alias: None
Product: Red Hat Enterprise Linux 5
Classification: Red Hat
Component: isdn4k-utils
Version: 5.3
Hardware: All
OS: Linux
low
low
Target Milestone: rc
: ---
Assignee: Than Ngo
QA Contact: desktop-bugs@redhat.com
URL:
Whiteboard:
Depends On:
Blocks:
TreeView+ depends on / blocked
 
Reported: 2009-05-21 23:44 UTC by Dave Malcolm
Modified: 2013-04-12 20:16 UTC (History)
2 users (show)

Fixed In Version:
Doc Type: Bug Fix
Doc Text:
Clone Of:
Environment:
Last Closed: 2013-03-26 17:22:44 UTC
Target Upstream Version:
Embargoed:


Attachments (Terms of Use)

Description Dave Malcolm 2009-05-21 23:44:42 UTC
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
.B readconf
and
.B writeconf.

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):
isdn4k-utils-3.2-51.el5

How reproducible:
100%; minor issue

Steps to Reproduce:
1. gunzip -c /usr/share/man/man8/isdnctrl_conf.8.gz
2. man 8 isdnctrl_conf
  
Actual results:
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)

Expected results:
Regular-looking manpage

Additional info:
(Found testing an automated manpage checker, testing all of manpages in RHEL 5.3)

Comment 8 Phil Knirsch 2013-03-26 17:21:50 UTC
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
defects.

However, Red Hat will further review this request for potential inclusion
in future major releases of Red Hat Enterprise Linux.


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