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

[egallager at gcc dot gnu.org]

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

Eric Gallager <egallager at gcc dot gnu.org> changed:

           What    |Removed                     |Added
----------------------------------------------------------------------------
           Keywords|                            |documentation
             Status|UNCONFIRMED                 |NEW
   Last reconfirmed|                            |2017-09-17
                 CC|                            |egallager at gcc dot gnu.org
            Summary|--help and --help=<value>   |document that --help and
                   |options cannot be combined. |--help=<value> options
                   |                            |cannot be combined.
     Ever confirmed|0                           |1
           Severity|normal                      |minor

--- Comment #2 from Eric Gallager <egallager at gcc dot gnu.org> ---
(In reply to Nick Clifton from comment #1)
> 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

Confirming as a documentation issue; please send your patch to the gcc-patches
mailing list for review.