unofficial mirror of emacs-devel@gnu.org 
 help / color / mirror / code / Atom feed
From: "Drew Adams" <drew.adams@oracle.com>
Subject: Help buffer link on name of customizable thing (at start of buffer)
Date: Sun, 20 Aug 2006 12:34:32 -0700	[thread overview]
Message-ID: <MEEKKIABFKKDFJMPIOEBKEDMDEAA.drew.adams@oracle.com> (raw)

Suggestion for after the release -

In buffer *Help*, for help on a thing that is customizable, put the same
link on the name of the customizable thing (e.g. user variable or face), at
the beginning of the *Help* buffer, that is currently put on the word
"customize" at the bottom of the buffer.

Advantage: When you use, say, `C-v some-option', you can hit RET
immediately, to customize the thing, since the cursor is at `point-min' by
default. This is quicker than using, e.g., `M-x customize-option': instead
of `M-x customize-option RET foo RET', just use `C-h v foo RET RET'.

It also obviates any need for separate key bindings for `customize-this' and
`customize-that', as long as there is a binding for `describe-this' and
that. Being handy, this will quickly become a main entry point for
Customize, which is not a bad thing, IMO: a *Help* description, with the
current value shown, is a good place to start, before customizing something.

I don't see any reason not to do this. While the use of this link won't be
as obvious (but there would be a help tooltip) as the "You can customize
this variable" at the buffer bottom, users will learn and appreciate this
convenience.

We should also, obviously, keep the more explicit link at the bottom: "You
can customize this variable".

Also, the same form (i.e., the same *Help* buffer layout) should be used for
faces and user options. This is not the case now. Currently, `describe-face'
puts a "(customize this face)" link right after the face name, on the first
*Help* buffer line, whereas `describe-variable' puts a "You can customize
this variable" link at the bottom of the buffer, just before the [back]
button. The latter form is preferable, IMO.

             reply	other threads:[~2006-08-20 19:34 UTC|newest]

Thread overview: 3+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2006-08-20 19:34 Drew Adams [this message]
2006-08-22  3:08 ` Help buffer link on name of customizable thing (at start of buffer) Richard Stallman
2006-08-22  3:52   ` Drew Adams

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

  List information: https://www.gnu.org/software/emacs/

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

  git send-email \
    --in-reply-to=MEEKKIABFKKDFJMPIOEBKEDMDEAA.drew.adams@oracle.com \
    --to=drew.adams@oracle.com \
    /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 public inbox

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

This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).