Re: '(info-stnd)Invoking Info' doesn't mention that '--show-options' requires arguments

[Alfred M. Szmidt]

   On Sun, Jan 30, 2022 at 10:18:37AM +0500, Akbarkhon Variskhanov wrote:
   > Hmm, I see. It is indeed very confusing but thanks for clearing that up
   > nonetheless.
   > 
   > Perhaps some other notation with an example is needed here

   I made the following change:

   @@ -487,9 +486,12 @@ @node Invoking Info
    @cindex @code{--show-options} (@code{--usage}, @code{-O}) command line 
option
    @cindex command-line options, how to find
    @cindex invocation description, how to find
   -Tell Info to look for the node that describes how to invoke the
   -program and its command-line options, and begin the session by
   -displaying that node.  It is provided to make it easier to find the
   +Look for the node that describes how to invoke the
   +program.  The name of the program is taken from the other non-option
   +arguments on the command line.  For example, @samp{info emacs -O} loads

It would be better to say "info -O emacs" -- since that is the
"standard" synopsis for commands and putting options at the end will
be slightly confusing to users, even though we allow out of order
options.

   I also plan to remove this option from the --help message.

Please don't, I don't understand why even ...  it is a very important
option for users, there is no other mention on how to get to the
invocation menu of a command in the --help output.

Instead, how about change this:

  -O, --show-options, --usage  go to command-line options node

into

  -O, --show-options, --usage  go to command-line options node for MENU-ITEM

but also improve the error message slightly, from

 info: No program name given

to
 info: No program name or menu item given for --show-option