all messages for Emacs-related lists mirrored at yhetil.org
 help / color / mirror / code / Atom feed
From: "Drew Adams" <drew.adams@oracle.com>
To: "'Stefan Monnier'" <monnier@iro.umontreal.ca>
Cc: 'martin rudalics' <rudalics@gmx.at>,
	"'Stephen J. Turnbull'" <stephen@xemacs.org>,
	emacs-devel@gnu.org
Subject: RE: option doc strings and Customize tags
Date: Wed, 29 Oct 2008 09:08:27 -0700	[thread overview]
Message-ID: <000601c939e0$9422dca0$c2b22382@us.oracle.com> (raw)
In-Reply-To: <jwvprljzczv.fsf-monnier+emacs@gnu.org>

> I think we should just add the value to the menu, together with some
> sanity check: if the printed representation of the value is too long,
> then shorten it by replacing the middle chars with "...", and let the
> code provide an override for those few remaining cases where it's
> not satisfactory.

That's the abbreviating I suggested. But I'd recommend eliding the terminal
chars, not the middle ones. In the case of a sexp, the normal elision should be
used (e.g. via `print-length') - such as is used in *Backtrace*, but more
abbreviated.

But don't you agree that we need really to provide the value only when it is a
symbol-valued `const' in a `choice'? I think those are about the only cases
where a doc string's reference to a value might lead to confusion wrt the
Customize tags.

If so, then there is no need to worry about sexps and strings and such. It is
only the occasional long symbol name that would need to be abbreviated (at its
end, not middle).





  reply	other threads:[~2008-10-29 16:08 UTC|newest]

Thread overview: 16+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2008-10-27 18:12 option doc strings and Customize tags Drew Adams
2008-10-28 19:09 ` martin rudalics
2008-10-28 19:28   ` Drew Adams
2008-10-28 19:38     ` Lennart Borgman
2008-10-28 19:49       ` Drew Adams
2008-10-28 20:03         ` Lennart Borgman
2008-10-28 20:25           ` Drew Adams
2008-10-28 20:29             ` Lennart Borgman
2008-10-30  5:01               ` Kevin Rodgers
2008-10-30  6:06                 ` Lennart Borgman
2008-10-29  2:33     ` Stephen J. Turnbull
2008-10-29  6:45       ` Drew Adams
2008-10-29 14:36         ` Stefan Monnier
2008-10-29 16:08           ` Drew Adams [this message]
2008-10-29 17:17             ` Stefan Monnier
2008-10-30  1:42             ` Stephen J. Turnbull

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='000601c939e0$9422dca0$c2b22382@us.oracle.com' \
    --to=drew.adams@oracle.com \
    --cc=emacs-devel@gnu.org \
    --cc=monnier@iro.umontreal.ca \
    --cc=rudalics@gmx.at \
    --cc=stephen@xemacs.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.