From: "Drew Adams" <drew.adams@oracle.com>
To: "'Eli Zaretskii'" <eliz@gnu.org>
Cc: 12853@debbugs.gnu.org
Subject: bug#12853: 24.2.50; doc of `color-defined-p'
Date: Sat, 10 Nov 2012 10:56:04 -0800 [thread overview]
Message-ID: <EDE2EF2A0F5A491292633324D4FE5EE0@us.oracle.com> (raw)
In-Reply-To: <83bof5xq8m.fsf@gnu.org>
> So these two functions do not support 1-to-1 correspondence of color
> names, as you seem to assume.
I do not assume anything about these functions.
> That would remove information that's important for someone who writes
> code which manipulates color names at a low level where these
> distinctions are important. It was important for me when I did that,
> and so I would object to removing this.
I'm not asking you to remove anything. I'm asking that the doc be corrected and
made more clear and complete.
If you feel it is important to mention those two noncolors here, please do so.
And consider mentioning also why that is important: why this function deals with
such exceptions.
If it is not appropriate to mention `defined-colors' here then, by all means, do
not do so. I was hunting for some definition of "defined color" that might be
pertinent here, but apparently that was a false route.
In any case, please make clear here just what is meant by a "defined color" in
this context, and how that definition relates to those particular noncolor
defined-color exceptions.
This is all the more important if, as seems to be the case, "defined color" here
is something not at all obvious, with kludgy exceptions.
IOW, if the meaning of "defined color" here were straightforward and we could
simply point to some other function (e.g. `defined-colors'), then doing that
would be appropriate and sufficient to make clear what that term means here.
Since the meaning is NOT obvious or straightforward, it needs to be provided
(explained).
next prev parent reply other threads:[~2012-11-10 18:56 UTC|newest]
Thread overview: 9+ messages / expand[flat|nested] mbox.gz Atom feed top
2012-11-10 16:46 bug#12853: 24.2.50; doc of `color-defined-p' Drew Adams
2012-11-10 17:50 ` Eli Zaretskii
2012-11-10 18:12 ` Drew Adams
2012-11-10 18:33 ` Eli Zaretskii
2012-11-10 18:56 ` Drew Adams [this message]
2012-11-10 19:17 ` Eli Zaretskii
2012-11-10 19:51 ` Drew Adams
2012-11-10 20:25 ` Eli Zaretskii
2012-11-23 7:56 ` Chong Yidong
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=EDE2EF2A0F5A491292633324D4FE5EE0@us.oracle.com \
--to=drew.adams@oracle.com \
--cc=12853@debbugs.gnu.org \
--cc=eliz@gnu.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 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).