Note: This bug is displayed in read-only format because the product is no longer active in Red Hat Bugzilla.

Bug 870032

Summary: devtoolset-1.1-binutils: wrong description of 'as -v' in man page
Product: Red Hat Developer Toolset Reporter: David Kaspar // Dee'Kej <deekej>
Component: binutilsAssignee: Patsy Griffin <pfrankli>
Status: CLOSED ERRATA QA Contact: Martin Cermak <mcermak>
Severity: low Docs Contact:
Priority: low    
Version: DTS 1.1 RHEL 6CC: law, mcermak, mfranc, mnewsome, mpolacek, ohudlick
Target Milestone: rcKeywords: Documentation, EasyFix
Target Release: 1.1   
Hardware: All   
OS: Linux   
Whiteboard:
Fixed In Version: devtoolset-1.1-binutils-2.23.51.0.3-3 Doc Type: Bug Fix
Doc Text:
Story Points: ---
Clone Of:
: 870125 1038339 (view as bug list) Environment:
Last Closed: 2013-01-22 14:39:26 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: 870125, 1038339    

Description David Kaspar // Dee'Kej 2012-10-25 12:49:15 UTC
Description of problem:
Manual page of GNU portable assembler 'as' has wrong description of -v option.
'-v' states for --verbose option, but in its man page it says, that '-v' option is used for showing version of this application.


Version-Release number of selected component (if applicable):
GNU assembler version 2.23.51.0.3-2.el6 20120918

How reproducible:
Always.


Steps to Reproduce:
1. Run 'as -v' and see its output.
2. Run 'as --verbose' and see its output.
Note: the outputs will be same and the program will be waiting for input from stdin.
3. Now run 'man as' and see the section describing '-v' option and what it says:
   "-v
    -version
         Print the as version."
  
Actual results:
Prints the version of the program. However, 'as' is then using --verbose mode and waiting for the input.

Expected results:
2 possible expected results:
-- 1) Man page is corrected and version displaying is provided only by '-version' and '--version' options.

-- 2) The as utility is patched to behave as described in its manual page. This would mean printing version information and exiting afterwards.


Additional info:
This issue has been found only on x86_64 RHEL-6.3 so far. However, it's possible that same issue is occuring on every other platform supported by DTS-1.1.

Comment 2 David Kaspar // Dee'Kej 2012-10-25 15:08:51 UTC
I can now confirm, that this bug is also present on i386 and ppc64 architectures of DTS1.1 for RHEL6.

Comment 3 Marek Polacek 2012-10-25 18:05:46 UTC
I believe only the manpage should be fixed: s/-version/-verbose/.

Comment 5 Marek Polacek 2012-10-26 13:58:47 UTC
I don't think this is sufficient, even this line should be adjusted:
[@b{-v}] [@b{-version}] [@b{--version}] [@b{-W}] [@b{--warn}]
and there are more occurrences of "[^-]-version".

Comment 6 Marek Polacek 2012-10-29 10:42:17 UTC
Duh.  On the second though, we just have to correct manpage in sense that `-version' also exits.

Comment 7 Marek Polacek 2012-10-29 11:23:44 UTC
Patch posted upstream.
http://sourceware.org/ml/binutils/2012-10/msg00466.html

Comment 8 Marek Polacek 2012-10-30 14:08:25 UTC
Fixed.

Comment 12 errata-xmlrpc 2013-01-22 14:39:26 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/RHEA-2013-0173.html