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

[Gavin Smith]

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
+the @code{Emacs Invocation} node of the @code{emacs} manual.
+
+This option is provided to make it easier to find the
 most important usage information in a manual without navigating
 through menu hierarchies.  The effect is similar to the @code{@kbd{M-x}
 goto-invocation} command (@pxref{goto-invocation}) from inside Info.



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