all messages for Emacs-related lists mirrored at yhetil.org
 help / color / mirror / code / Atom feed
From: Luc Teirlinck <teirllm@dms.auburn.edu>
Cc: Karl Berry <karl@freefriends.org>
Subject: Info-scroll-prefer-subnodes default in Emacs.
Date: Thu, 19 Jun 2003 20:19:44 -0500 (CDT)	[thread overview]
Message-ID: <200306200119.h5K1Jic11729@eel.dms.auburn.edu> (raw)

I am rewriting parts of the Info tutorial.  This took me a little bit
longer than expected, because I had to learn texinfo first (which I
had never used before) and because I checked the entire tutorial for
undocumented differences between the Emacs and stand-alone versions.
I am about ready to send a proposed revision to Karl for review.
Before I can do that however, I feel that the following problem needs
to be addressed.

One of the differences between the Emacs and stand-alone versions is
the behavior of <SPC>.  The tutorial describes the stand-alone
version.  I could try to torture the brains of unsuspecting newbies by
trying to explain them the subtleties of the Emacs version.  However,
I believe that it would make a lot more sense to change the default
Emacs behavior to the stand-alone behavior, by changing the default
value of Info-scroll-prefer-subnodes from t to nil.

Description of the stand-alone behavior:

   <SPC> and <DEL> not only move forward and backward through the
current node.  They also move between nodes.  <SPC> at the end of a
node moves to the next node; <DEL> (or <BACKSPACE>) at the beginning
of a node moves to the previous node.  In effect, these commands
scroll through all the nodes in an Info file as a single logical
sequence.  You can read an entire manual top to bottom by just typing
<SPC>, and move backward through the entire manual from bottom to top
by typing <DEL> (or <BACKSPACE>).

My comments:

Makes sense, is intuitive, easy to understand, and obviously useful.
Perfectly consistent with the usual Emacs behavior of <SPC> in other
read-only documentation-style buffers.

Emacs behavior:

Same a stand-alone, except when menus come in sight.  Then things get
wild.  Then we go to some menu entry.  Surprising enough to newbies.
But which menu entry?

Consider the following part of the dir file:

* CC Mode: (ccmode).   Emacs mode for editing C, C++, Objective-C,
                          Java, Pike, and IDL code.
* CL: (cl).	       Partial Common Lisp support for Emacs Lisp.

With point on the "J" of "Java" where do we go to?  To CL, "of
course".  It might actually make more sense for <SPC> to do that than
for RETURN (which now visits CC Mode) because RETURN is supposed to
visit the node to which the description refers, whereas <SPC> is
supposed to scroll FORWARD and hence visiting CL might make
(relatively) more sense than visiting CC mode.  Might be OK for some
advanced users, but way too complicated and subtle for newbies (as
well as for me, actually).

Throughout Emacs, <SPC> in read-only buffers usually scrolls forward
but does NOT visit "the next thing referenced past point".  

Somebody tries C-h i for the very first time.  Huge dir buffer.  So
the first thing we do is what we are used to do in documentation style
read-only buffers, say NEWS (C-h n), we type <SPC> to browse through
the huge list of entries.  What happened?  Where did we go to and why?

I believe that the obvious thing to do is to change the default value
of `Info-scroll-prefer-subnodes' from t to nil.  Way more transparent
to newbies and eliminates one more difference between the Emacs and
stand-alone versions.  Advanced users who find the more complex
current Emacs behavior more convenient can easily customize the
variable.

Sincerely,

Luc.

             reply	other threads:[~2003-06-20  1:19 UTC|newest]

Thread overview: 14+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2003-06-20  1:19 Luc Teirlinck [this message]
2003-06-21  4:56 ` Info-scroll-prefer-subnodes default in Emacs Richard Stallman
2003-06-24  2:55   ` Luc Teirlinck
2003-06-24  3:50     ` Luc Teirlinck
2003-06-24  3:56       ` Luc Teirlinck
2003-06-25  2:56       ` Richard Stallman
2003-06-24  4:12     ` Eli Zaretskii
2003-06-25  3:03       ` Luc Teirlinck
2003-06-25  2:57     ` Richard Stallman
  -- strict thread matches above, loose matches on Subject: below --
2003-06-20 13:55 Karl Berry
2003-06-23  1:57 ` Miles Bader
2003-06-24 13:26 Karl Berry
2003-06-25 13:43 Karl Berry
2003-06-26  5:30 ` Richard Stallman

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

  Avoid top-posting and favor interleaved quoting:
  https://en.wikipedia.org/wiki/Posting_style#Interleaved_style

* Reply using the --to, --cc, and --in-reply-to
  switches of git-send-email(1):

  git send-email \
    --in-reply-to=200306200119.h5K1Jic11729@eel.dms.auburn.edu \
    --to=teirllm@dms.auburn.edu \
    --cc=karl@freefriends.org \
    /path/to/YOUR_REPLY

  https://kernel.org/pub/software/scm/git/docs/git-send-email.html

* If your mail client supports setting the In-Reply-To header
  via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line before the message body.
Code repositories for project(s) associated with this external index

	https://git.savannah.gnu.org/cgit/emacs.git
	https://git.savannah.gnu.org/cgit/emacs/org-mode.git

This is an external index of several public inboxes,
see mirroring instructions on how to clone and mirror
all data and code used by this external index.