RE: Info-build-node-completions has an extra `*' node

["Drew Adams" <drew.adams@oracle.com>]

> From: Bastien Guerry Sent: Monday, February 18, 2008 4:49 PM
> >>> `g' lists all node names (the virtual Info file `dir' has only one
> >>> node `Top' so it is right for `g' to list only this single node.)
> >
> > Why would someone normally want a completion on Info file 
> > names instead of Info manual names with typing `m TAB'?
> 
> I think this boils down to disambiguate what a "menu item" refers to.
> In a manual, a menu item is a node; in (dir), a menu item is a really
> a file name (a manual.)
> 
> My point is that, when listed in (dir), a manual looks like a node.
> Hence the user might expect `Info-goto-node' to offer completion on 
> the manuals as well.
> 
> In fact, I find `Info-menu' and `Info-goto-node' to be a bit 
> redundant, and the fact that `Info-goto-node' is not helpful in
> (dir) doesn't help the two commands to be less redundant.

I have no opinion so far about completing against file names along with node
names.

However, I too feel that it would be great to treat the menu at the (dir)
level the same way menus are treated within a manual - that is, to be able
to use `g' to complete against manual names when in (dir), just as you can
complete against node names (which correspond loosely to menu item names)
when in a manual.

A propos, in Icicles, you can do the following. (I'm not suggesting this for
Emacs; I mention it to show that it would be handy to treat (dir)
manuals/menu items similarly to nodes in manuals.)

1. `g' is a multi-command. So you can repeatedly use `C-next' and other keys
to traverse the Info hierarchy, displaying different nodes. You can use
completion to match node names, and you can access nodes in any order.

2. You can hit `C-,' to sort the node list (*Completions*) in book order.
Icicles lets you cycle among completions, so this makes it easy to traverse
the node hierarchy in order. The effect is a bit similar to using SPC and
DEL (without scrolling), but you remain within the call to `g'.

3. `C-u g' opens a new window, just as for vanilla Emacs. But a negative
prefix arg, `M--', has this behavior:

3a. It sorts the nodes in book order (no need to hit `C-,').

3b. It removes all nodes that come before the current node from the
completion set, so you see (and complete against) only the nodes that remain
in the book, after the current node. This makes completion easier (smaller
domain).

3c. Except at the Top level, it adds a pseudo-node completion candidate,
`..', which takes you up to the parent node. If you go up all the way to the
Top node, then all candidates become available, but the current candidate is
the current node, facilitating continuing back down into the manual where
you were. (The "current candidate" has to do with candidate cycling in
Icicles.)


So you can see that this, as Bastien hints, brings `g' and `m' together, in
a way: You can use the same command, `g', to either navigate nodes by name
(alphabetical order for completions) or by menu (book order for
completions).

And you can see that it would be handy to be able do the same thing at the
(dir) level. Currently, since there are no nodes at that level (even though
there is a menu of manuals), you just get the single node "Top  This is the
top of the INFO tree" as the only candidate for completion.

http://www.emacswiki.org/cgi-bin/wiki/Icicles_-_Info_Enhancements