Re: info info; man info (documentation about info)

On Sat, Jan 07, 2023 at 11:37:35PM +0100, Alejandro Colomar wrote:
> Hi Arsen,
> 
> On 1/7/23 21:33, Arsen Arsenović wrote:
> > Hi Alex,
> > 
> > Alejandro Colomar <[email protected]> writes:
> > 
> > > Hello,
> > > 
> > > As someone with zero knowledge of how info(1) works, but considerable knowledge
> > > of how to read a manual page (well, there's little to it; less(1) is really
> > > simple), I'd like to recommend something for the info(1) manual page.
> > 
> > Check out ``info "(info)Help"''.
> 
> That brings me to the same as `man info`.

It is likely that info.info isn't installed on your system as this file
comes with Emacs.

> [
> Next: Stand-alone Info,  Up: (dir)
> 
> Stand-alone GNU Info
> ********************
> 
> This documentation describes the stand-alone Info reader which you can
> use to read Info documentation.
> 
>    If you are new to the Info reader, then you can get started by typing
> 'H' for a list of basic key bindings.  You can read through the rest of
> this manual by typing <SPC> and <DEL> (or <Space> and <Backspace>) to
> move forwards and backwards in it.
> ]
> 
> 
> However, help that explains how to navigate is of little help if I first
> don't know how documentation is organized.  In a manual page, it is simple:
> documentation for something is in a single page.  In Texinfo, there is a
> nodes a dir, a pointer, a file, a tree, ...  and I don't know what they
> mean.

We could try to streamline the documentation in info-stnd.info so
that repeatedly pressing the space bar gets you the information you
need as soon as possible, without having to read past all the command-line
options.  We could move the "Selecting a Node" section earlier.