bug#10834: 24.0.93; ediff manual: node name of "Quick Help Commands"

bug#10834: 24.0.93; ediff manual: node name of "Quick Help Commands"

[Michael Heerdegen]

Hello,

Just now I tried to find a listing of the most important Ediff
commands in the ediff manual.  It took me quite a while to find out
that the according node is named "Quick Help Commands".  The name
suggests that it explains help commands for elisp - that's why I
didn't look at it.

A better name would be good ("Major Commands"?  "Quick Help on
Commands"?  Dunno.)


Michael




In GNU Emacs 24.0.93.1 (i486-pc-linux-gnu, GTK+ Version 3.2.3)
 of 2012-02-16 on zelenka, modified by Debian
 (emacs-snapshot package, version 2:20120216-1)
Windowing system distributor `The X.Org Foundation', version 11.0.11103901
Configured using:
 `configure '--build' 'i486-linux-gnu' '--host' 'i486-linux-gnu'
 '--prefix=/usr' '--sharedstatedir=/var/lib' '--libexecdir=/usr/lib'
 '--localstatedir=/var' '--infodir=/usr/share/info'
 '--mandir=/usr/share/man' '--with-pop=yes'
 '--enable-locallisppath=/etc/emacs-snapshot:/etc/emacs:/usr/local/share/emacs/24.0.93/site-lisp:/usr/local/share/emacs/site-lisp:/usr/share/emacs/24.0.93/site-lisp:/usr/share/emacs/site-lisp'
 '--without-compress-info' '--with-crt-dir=/usr/lib/i386-linux-gnu/'
 '--with-x=yes' '--with-x-toolkit=gtk3' '--with-imagemagick=yes'
 'build_alias=i486-linux-gnu' 'host_alias=i486-linux-gnu'
 'CFLAGS=-DDEBIAN -DSITELOAD_PURESIZE_EXTRA=5000 -g -O2''

Important settings:
  value of $LC_ALL: de_DE.utf8
  value of $LC_COLLATE: nil
  value of $LC_CTYPE: nil
  value of $LC_MESSAGES: nil
  value of $LC_MONETARY: nil
  value of $LC_NUMERIC: nil
  value of $LC_TIME: C
  value of $LANG: de_DE.utf8
  value of $XMODIFIERS: nil
  locale-coding-system: utf-8-unix
  default enable-multibyte-characters: t

bug#10834: 24.0.93; ediff manual: node name of "Quick Help Commands"

[Glenn Morris]

Michael Heerdegen wrote:

> Just now I tried to find a listing of the most important Ediff
> commands in the ediff manual.  It took me quite a while to find out
> that the according node is named "Quick Help Commands".

I don't use ediff, but reading the manual I see:
    
    All Ediff commands are displayed in a Quick Help window[...]
    The Quick Help commands are detailed below.
    [...]
    @menu
    * Quick Help Commands::             Frequently used commands.

which all seems logical.

bug#10834: 24.0.93; ediff manual: node name of "Quick Help Commands"

[Michael Heerdegen]

Glenn Morris <rgm@gnu.org> writes:

> > Just now I tried to find a listing of the most important Ediff
> > commands in the ediff manual.  It took me quite a while to find out
> > that the according node is named "Quick Help Commands".
>
> I don't use ediff, but reading the manual I see:
>     
>     All Ediff commands are displayed in a Quick Help window[...]
>     The Quick Help commands are detailed below.
>     [...]
>     @menu
>     * Quick Help Commands::             Frequently used commands.
>
> which all seems logical.

I totally agree that it's logical.  But it should also be possible to
find this node without knowing this logic or reading much text.

Ok, let's keep the node name.  But then, at least the index should be
improved.  I.e. if you hit i, there should be an entry named "Main
Commands" or "Important Commands" or similar.


Michael

bug#10834: 24.0.93; ediff manual: node name of "Quick Help Commands"

[Chong Yidong]

Michael Heerdegen <michael_heerdegen@web.de> writes:

> Ok, let's keep the node name.  But then, at least the index should be
> improved.  I.e. if you hit i, there should be an entry named "Main
> Commands" or "Important Commands" or similar.

I added "important commands" and "command help" entries.