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.
