Re: Improving documentation for the info mode

[Roland Winkler]

"Eli Zaretskii" <eliz@is.elta.co.il> writes:

> > From: Pr Kurlberg <kurlberg@math.chalmers.se>
> > Date: Wed, 19 Sep 2001 16:37:06 +0200 (MET DST)
> > 
> > Please consider mentioning the 'i' (Info-index) command in the
> > 'Getting Started' section of the info node on info.  (Or perhaps
> > mention it in the 'Advanced Info' node.)  I just learned about the 'i'
> > command from reading a news group, and I find it very useful!

Another suggestion for improving the documentation for the
info mode:

At a first glance, the functions Info-menu (`m') and Info-goto-node
(`g') do very similar things. Unfortunately, I find the docstrings
not too helpful if one wants to figure out what is the difference
between these two functions. (Moreover the docstrings do not follow
the usual rule on how to refer to arguments of a function.)
Therefore, I suggest that the docstrings should be changed to
something like



Info-menu

Go to info node MENU-ITEM listed in the menu of the current info node.
Completion is allowed, and the menu item point is on is the default.

    Maybe I missed the point: Does the "abbreviated" in the present
    docstring refer to anything beyond what I usually expect from
    minibuffer completion?



Info-goto-node

Go to info node NODENAME in the current info file.
If NODENAME has a value (FILENAME)NAME it refers to node NAME in FILENAME.
Completion is allowed.


Roland