Re: give --index-search example on man page

[Gavin Smith]

On Sun, Sep 28, 2014 at 1:01 AM, 積丹尼 Dan Jacobson <address@hidden> wrote:
> On the info man page, after

Note that the man page is automatically generated from the output of
"info --help".

>
>        info emacs buffers
>               start at buffers node within emacs manual
>
> Please add
>
>        info grub commands 'command-line and menu entry commands' badram
>        info --index-search=badram grub
>               start at badram node within grub manual
>
> So one can realize it is not so simple.

The first command there is following menus to get to the desired node,
and the second is looking up in an index. Neither is explicitly
loading a node called "badram". To do that, use "info -f grub -n
badram". (The current development version allows "info grub -n badram"
as well.) You can also do "info -n '(grub)'badram".

The "info emacs buffers" example could be misleading, as you found.
That is to select the menu entry called "buffers" in the "Top" node of
the emacs Info manual.

>
> Also consider making an -i shortcut to reduce the pain.
>

Maybe, if it is a commonly-used enough option. (I'd prefer -I over -i,
though.) There are a few ways to search in the indices including using
the "i" or "I" commands once the program is started. (Future versions
will search in the indices for "badram" for the command "info grub
badram" if no "badram" entry is found in the top-level menu of the
"grub" file that it finds. )