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

[Akbarkhon Variskhanov]

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, like bash(1) does with stdout and stderr redirection:

There are two formats for redirecting standard output and standard error:

    &>word

and
    >&word

Of the two forms, the first is preferred.

On Sun, Jan 30, 2022 at 5:35 AM Gavin Smith <gavinsmith0123@gmail.com> wrote:

On Thu, Jan 27, 2022 at 11:25:38PM +0500, Akbarkhon Variskhanov wrote:
> doc/info-stnd.texi#n483
> <https://git.savannah.gnu.org/cgit/texinfo.git/tree/doc/info-stnd.texi#n483>
> info/info.c#n1109
> <https://git.savannah.gnu.org/cgit/texinfo.git/tree/info/info.c#n1109>
>
> Something like:
>
> > '--show-options PROGRAM'
> > '--usage PROGRAM'
> > '-O PROGRAM'
> >
> is needed to make it clearer. I thought info --usage would display a short
> summary for *info*'s options like it does in many other GNU programs but
> *info* returns 1 on exit instead and outputs this message:
>
> > info: No program name given
> >

I see it is potentially confusing but the -O option doesn't actually take
an argument.  So 'info -O bash' is exactly the same as 'info bash -O'.

It is usually the --help option that is used for a summary of a programs
options rather than --usage.