all messages for Emacs-related lists mirrored at yhetil.org
 help / color / mirror / code / Atom feed
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).






  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

* 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 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.