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 <[email protected]> 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. >
