Bug 891928

Summary: Inconsistency between 'man man' and 'man -h'
Product: Red Hat Enterprise Linux 6 Reporter: Martin Kyral <mkyral>
Component: man-pages-overridesAssignee: Jan Chaloupka <jchaloup>
Status: CLOSED ERRATA QA Contact: Iveta Wiedermann <isenfeld>
Severity: unspecified Docs Contact:
Priority: unspecified    
Version: 6.4CC: isenfeld, ovasik
Target Milestone: rcKeywords: ManPageChange, Patch
Target Release: ---   
Hardware: Unspecified   
OS: Unspecified   
Whiteboard:
Fixed In Version: man-pages-overrides-6.6.2-1.el6 Doc Type: Bug Fix
Doc Text:
Story Points: ---
Clone Of: Environment:
Last Closed: 2014-10-14 07:25:56 UTC Type: Bug
Regression: --- Mount Type: ---
Documentation: --- CRM:
Verified Versions: Category: ---
oVirt Team: --- RHEL 7.3 requirements from Atomic Host:
Cloudforms Team: --- Target Upstream Version:
Embargoed:
Bug Depends On:    
Bug Blocks: 1119595    
Attachments:
Description Flags
man.1 -D missing in synopsis none

Description Martin Kyral 2013-01-04 14:24:24 UTC 
Description of problem:
There are some option of the man command, that are documented in its man page, but not in the usage information shown by 'man -h'.
Also, some options are described in the detailed documentation, but missing from man page synopsis or usage line respectively.

1) -B -H -F options are documented only in the man page
2) -D option is documented in the OPTIONS section of the man page, but missing in SYNOPSIS
3) -C -D options are documented in the detailed part of the man -h output, but missing from the usage line

Version-Release number of selected component (if applicable):
man-1.6f-32.el6

How reproducible:
Always

Steps to Reproduce:
1. compare 'man man' and 'man -h' output
2. compare SYNOPSIS and OPTIONS sections of the man page
3. compare usage line and the detailed options description in the 'man -h' output
  
Actual results:
See description

Expected results:
All available options are listed in both man page and 'man -h'. All of them are included in SYNOPSIS or usage line respectively.
Comment 2 Martin Kyral 2013-01-04 14:44:27 UTC 
Following binaries from the man package have similar issues:

man2html lacks the following options in the command line usage information (compared to its man page): -D -E -H -L -M

makewhatis lacks the following options in the command line usage information (compared to its man page): -U -o
Comment 3 RHEL Program Management 2013-01-08 06:47:26 UTC 
This request was not resolved in time for the current release.
Red Hat invites you to ask your support representative to
propose this request, if still desired, for consideration in
the next release of Red Hat Enterprise Linux.
Comment 4 Jan Chaloupka 2014-06-20 11:12:12 UTC 
> 2. compare SYNOPSIS and OPTIONS sections of the man page
is simple fix,

> 1. compare 'man man' and 'man -h' output
> 3. compare usage line and the detailed options description in the 'man -h' output
man is not on ACL and as this is a change into man package, this will not be fixed in rhel6.6. You can clone this bug mentioning 1. and 3. for rhel6.7.
Comment 5 Jan Chaloupka 2014-06-20 11:13:34 UTC 
Created attachment 910759 [details]
man.1 -D missing in synopsis
Comment 11 errata-xmlrpc 2014-10-14 07:25:56 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-2014-1382.html