Re: Problems with info (emacs version)

[Luc Teirlinck]

Richard Stallman wrote:

       1.  Easiest one to fix:

           (info)Help-M

           which is used in the tutorial, *only* describes menus as they
           appear in the standalone info, not as they appear in the emacs
           version and the two are very different.

   Would you please tell me the specific differences?  I scanned through
   that none and did not notice anything incorrect.

Yes. From (info)Help-M:

       * Foo:  Node about FOO.      This tells about FOO.

     The subtopic name is Foo, and the node describing it is `Node about
  FOO'.  The rest of the line is just for the reader's Information.  [[
  But this line is not a real menu item, simply because there is no line
  above it which starts with `* Menu:'.]]

     When you use a menu to go to another node (in a way that will be
  described soon), what you specify is the subtopic name, the first
  thing
  in the menu line.  Info uses it to find the menu line, extracts the
  node name from it, and goes to that node.  The reason that there is
  both a subtopic name and a node name is that the node name must be
  meaningful to the computer and may therefore have to be ugly looking.
  The subtopic name can be chosen just to be convenient for the user to
  specify.  Often the node name is convenient for the user to specify
  and
  so both it and the subtopic name are the same.  There is an
  abbreviation for this:

       * Foo::   This tells about FOO.

  This means that the subtopic name and node name are the same; they are
  both `Foo'.

My own remarks:

Note that this goes into quite some length explaining why the user
sees both a 

"*Foo:" and a "Node about Foo" and what the difference is,

but the user using Emacs, sees only:

"*Foo".  Nowhere is it told that ":   Node about FOO" is normally
invisible in Emacs.  The user looks for it, can not find it and does
not know what is going on.

       * Foo::   This tells about FOO.

  This means that the subtopic name and node name are the same; they
  are
  both `Foo'.

Again, only:

* Foo is visible in Emacs, not the "::" The Emacs info user has no
  idea what all of this stuff about special meaning of "::" is about.

Of course, the entire discussion *is* correct if you know about the
invisible text.  One would not have to make a lot of changes in the
documentation if one would provide the user with convenient commands
in Info to toggle invisibility, say `v'. All one would have to do
would be to tell the user that in Emacs you first have to type `v' to
see the text being talked about.  I could easily implement such a
visibility toggling feature myself, if you would agree with it.

Sincerely,

Luc.