[Top][All Lists]

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

Improving documentation for the info mode

From: Pär Kurlberg
Subject: Improving documentation for the info mode
Date: Wed, 19 Sep 2001 16:37:06 +0200 (MET DST)

This bug report will be sent to the Free Software Foundation,
 not to your local site managers!!
Please write in English, because the Emacs maintainers do not have
translators to read other languages for them.

In GNU Emacs 20.4.1 (sparc-sun-solaris2.6, X toolkit)
 of Tue Nov 30 1999 on bigmama.md.chalmers.se
configured using `configure  --prefix=/share/usr/pd/gnu/emacs --with-pop 
--with-kerberos --with-gcc=no --infodir=/usr/pd/gnu/info 
--x-includes=/usr/X11/include --x-libraries=/usr/X11/lib'

Please describe exactly what actions triggered the bug
and the precise symptoms of the bug:

This is not quite a bug, but I think the info documentation ('Getting
Started') of the info mode could be improved:

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!
However, it is difficult to find the command in the info
documentation.  Of course, C-h m lists 'i' as a possible command, but
unless you read the whole list, you will never find out about this
useful command.  (Perhaps the problem is my habit of not using C-h m,
most of the time I find myself overwhelmed by the number of commands

I believe this change would make it easier for new users to learn how
to use info more effectively.

Par Kurlberg

Recent input:
C-v n SPC n d m i n SPC f SPC return C-n C-n C-n C-n 
C-n C-n C-n C-n C-n C-n C-n C-n C-n C-n C-n C-n SPC 
SPC SPC M-x e m SPC a SPC b SPC u SPC backspace backspace 
r C-a C-k r e SPC backspace backspace backspace b u 
SPC SPC C-h a b backspace C-g C-h a b u g return C-x 
o C-s r e p C-s C-s C-s C-s C-a C-s e m a s C-a M-x 
r e p SPC o SPC SPC r SPC e m SPC b SPC return

Recent messages:
Type M-x switch-to-buffer-other-window RET to restore the other window.  M-C-v 
to scroll the help.
Making completion list... [4 times]
Command attempted to use minibuffer while in minibuffer
Type C-x 1 to remove help window.  M-C-v to scroll the help.
Mark saved where search started [2 times]
Making completion list... [3 times]
Loading emacsbug...
Loading emacsbug...done

reply via email to

[Prev in Thread] Current Thread [Next in Thread]