unofficial mirror of emacs-devel@gnu.org 
 help / color / mirror / code / Atom feed
From: "Drew Adams" <drew.adams@oracle.com>
Subject: RE: [drew.adams@oracle.com: RE: Customize doc strings and tagstrings do not respect \\<...> and \\[...]]
Date: Sat, 4 Mar 2006 14:14:50 -0800	[thread overview]
Message-ID: <DNEMKBNJBGPAOPIJOOICOEFDDDAA.drew.adams@oracle.com> (raw)
In-Reply-To: <jer75hevu6.fsf@sykes.suse.de>

    > (defcustom titi 'tata "OK" :type
    >  '(choice
    >    (const :tag "`\\<minibuffer-local-map>\\[next-history-element]'."
    >           tata)))
    > I see in Customize what I reported initially:
    > \<minibuffer-local-map>\[next-history-element] (one level of
    > \ removed).

    Why do you think this is a bug?  The tag contains exactly this text.

What are you saying?

The point (the bug) is that the tag text should implicitly have
`substitute-command-keys' applied to it. I made that clear in my initial
report. A :tag string should be treated, in this respect, the same way a doc
string is treated.

Use case: You have a choice between two values for an option. Each controls
the behavior of `next-history-element' in a different way. You want to be
able to use `\\<minibuffer-local-map>\\[next-history-element]' in the :tag's
to refer to the command binding. You don't want to hard-code the binding in
the :tag string.

    > 2. BTW, if I eval the defcustom I sent originally (quoted
    > above), without
    > defining `my-map', then I get this in Customize, with a
    > warning message
    > spliced into the middle of the key description:
    >
    >  Behavior of ` Hide Rest
    >  Uses keymap "my-map", which is not currently defined.
    >  M-x my-cmd' when foobaz is in the wind.
    >  Parent groups: Nil
    >
    > This appears to be another bug.

    No.  This is the correct rendition of \<my-map> when my-map is not
    defined.

If one defines "correct rendition" by whatever the program does currently,
then of course there can be no bug. "Circulez, il n'y a rien a voir!"

Does that "rendition" look correct to you? Splicing in the error message in
place of the \\<...>?  With a button ("Hide Rest") inside the string `...'
along with the message?  Do you think this is the best way to present such a
message? Not to mention that (presumably) part of the message is missing
(just what is it that "uses keymap..."?).

I cannot believe that someone would look at that Custom buffer and say that
there is no bug, that this is what we should present to users. The UI should
not compound the problem of an undefined map by making a mess of things. It
is not the user's fault that the map is undefined; the UI should aid the
user as best it can, not throw up at him.

These might not be earth-shaking bugs, but that is no reason to close them
cavalierly, with an attitude that the program does what it does. Put them on
the back burner if you don't think they are important or don't want to work
on them, but please don't take the attitude that whatever is is right.

  reply	other threads:[~2006-03-04 22:14 UTC|newest]

Thread overview: 23+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2006-02-27  8:59 [drew.adams@oracle.com: RE: Customize doc strings and tag strings do not respect \\<...> and \\[...]] Richard Stallman
2006-03-04 14:57 ` Chong Yidong
2006-03-04 17:55   ` [drew.adams@oracle.com: RE: Customize doc strings and tagstrings " Drew Adams
2006-03-04 21:36     ` Andreas Schwab
2006-03-04 22:14       ` Drew Adams [this message]
2006-03-05 10:17         ` Andreas Schwab
2006-03-05 15:30           ` Drew Adams
2006-03-05 15:44             ` Andreas Schwab
2006-03-06  0:49           ` Richard Stallman
2006-03-06 13:13             ` Andreas Schwab
2006-03-06 22:48               ` Richard Stallman
2006-03-05 11:05         ` Andreas Schwab
2006-03-06  0:49         ` Richard Stallman
2007-02-15 11:44           ` Juanma Barranquero
2007-02-16  7:45             ` Richard Stallman
2007-02-16  9:49               ` Juanma Barranquero
2007-02-17  1:03                 ` Richard Stallman
2007-02-17  1:23                   ` Juanma Barranquero
2006-03-08 20:49         ` Kevin Rodgers
2006-03-08 21:28           ` Drew Adams
2006-03-27 17:09             ` Per Abrahamsen
2006-03-27 23:51               ` [drew.adams@oracle.com: RE: Customize doc strings andtagstrings " Drew Adams
2006-03-29  8:12                 ` 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

  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=DNEMKBNJBGPAOPIJOOICOEFDDDAA.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).