[Bug other/31357] New: --help and --help=<value> options cannot be combined.

[Bug other/31357] New: --help and --help=<value> options cannot be combined.

[brooks at gcc dot gnu dot org]

As documented, using multiple --help=<value> options in one command line
produces an output that concatenates the output from the various --help=<value>
options.

However, using both --help and --help=<value> gives only the --help output,
regardless of the order in which they are specified.


-- 
           Summary: --help and --help=<value> options cannot be combined.
           Product: gcc
           Version: 4.3.0
            Status: UNCONFIRMED
          Severity: normal
          Priority: P3
         Component: other
        AssignedTo: unassigned at gcc dot gnu dot org
        ReportedBy: brooks at gcc dot gnu dot org


http://gcc.gnu.org/bugzilla/show_bug.cgi?id=31357

[Bug other/31357] --help and --help=<value> options cannot be combined.

[nickc at redhat dot com]

------- Comment #1 from nickc at redhat dot com  2007-03-28 13:50 -------
Hi Brooks,

I do not think that this is a bug, although it is possibly a documentation
issue.  The --help=<> option restricts the output to a specified subset of the
full output obtained with just the --help option.  Thus it makes sense that if
both --help and --help=<> are specified on the same command line and that it is
documentated that --help=<> options combine, then the output should be the
entire --help output.

So, how do you feel about this patch ?

Cheers
  Nick

gcc/ChangeLog
2007-03-28  Nick Clifton  <nickc@redhat.com>

        PR driver/31357
        * doc/invoke.texi (--help=): Document that --help overrides --help=.

Index: gcc/doc/invoke.texi
===================================================================
--- gcc/doc/invoke.texi (revision 123290)
+++ gcc/doc/invoke.texi (working copy)
@@ -1169,7 +1177,9 @@ optimization options the following can b

 The @option{--help=} option can be repeated on the command line.  Each
 successive use will display its requested class of options, skipping
-those that have already been displayed.
+those that have already been displayed.  If @option{--help} is also
+specified anywhere on the command line then this will take precedence
+over any @option{--help=} option.

 If the @option{-Q} option appears on the command line before the
 @option{--help=} option, then the descriptive text displayed by


-- 


http://gcc.gnu.org/bugzilla/show_bug.cgi?id=31357