From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Eli Zaretskii Newsgroups: gmane.emacs.bugs Subject: bug#12853: 24.2.50; doc of `color-defined-p' Date: Sat, 10 Nov 2012 21:17:52 +0200 Message-ID: <83625dxo67.fsf@gnu.org> References: <10495ABA26F14041A1E374AC3B820F6E@us.oracle.com> <83d2zlxs8g.fsf@gnu.org> <7DA4A38C21E342A8A4061EC7D8257556@us.oracle.com> <83bof5xq8m.fsf@gnu.org> Reply-To: Eli Zaretskii NNTP-Posting-Host: plane.gmane.org X-Trace: ger.gmane.org 1352575139 31935 80.91.229.3 (10 Nov 2012 19:18:59 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Sat, 10 Nov 2012 19:18:59 +0000 (UTC) Cc: 12853@debbugs.gnu.org To: Drew Adams Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Sat Nov 10 20:19:09 2012 Return-path: Envelope-to: geb-bug-gnu-emacs@m.gmane.org Original-Received: from lists.gnu.org ([208.118.235.17]) by plane.gmane.org with esmtp (Exim 4.69) (envelope-from ) id 1TXGaC-0008F2-6P for geb-bug-gnu-emacs@m.gmane.org; Sat, 10 Nov 2012 20:19:08 +0100 Original-Received: from localhost ([::1]:43640 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1TXGa2-00089k-Ob for geb-bug-gnu-emacs@m.gmane.org; Sat, 10 Nov 2012 14:18:58 -0500 Original-Received: from eggs.gnu.org ([208.118.235.92]:36298) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1TXGZw-0007vb-LC for bug-gnu-emacs@gnu.org; Sat, 10 Nov 2012 14:18:55 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1TXGZt-0003ko-IP for bug-gnu-emacs@gnu.org; Sat, 10 Nov 2012 14:18:52 -0500 Original-Received: from debbugs.gnu.org ([140.186.70.43]:49734) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1TXGZt-0003kk-Es for bug-gnu-emacs@gnu.org; Sat, 10 Nov 2012 14:18:49 -0500 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.72) (envelope-from ) id 1TXGa7-0005yh-FY for bug-gnu-emacs@gnu.org; Sat, 10 Nov 2012 14:19:03 -0500 X-Loop: help-debbugs@gnu.org Resent-From: Eli Zaretskii Original-Sender: debbugs-submit-bounces@debbugs.gnu.org Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Sat, 10 Nov 2012 19:19:03 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 12853 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: Original-Received: via spool by 12853-submit@debbugs.gnu.org id=B12853.135257512322934 (code B ref 12853); Sat, 10 Nov 2012 19:19:03 +0000 Original-Received: (at 12853) by debbugs.gnu.org; 10 Nov 2012 19:18:43 +0000 Original-Received: from localhost ([127.0.0.1]:59981 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1TXGZn-0005xr-4C for submit@debbugs.gnu.org; Sat, 10 Nov 2012 14:18:43 -0500 Original-Received: from mtaout22.012.net.il ([80.179.55.172]:45148) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1TXGZk-0005xi-I1 for 12853@debbugs.gnu.org; Sat, 10 Nov 2012 14:18:41 -0500 Original-Received: from conversion-daemon.a-mtaout22.012.net.il by a-mtaout22.012.net.il (HyperSendmail v2007.08) id <0MDA00A00D4JN700@a-mtaout22.012.net.il> for 12853@debbugs.gnu.org; Sat, 10 Nov 2012 21:17:43 +0200 (IST) Original-Received: from HOME-C4E4A596F7 ([87.69.4.28]) by a-mtaout22.012.net.il (HyperSendmail v2007.08) with ESMTPA id <0MDA00A4HDLILD40@a-mtaout22.012.net.il>; Sat, 10 Nov 2012 21:17:43 +0200 (IST) In-reply-to: X-012-Sender: halo1@inter.net.il X-Spam-Score: 1.5 (+) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.13 Precedence: list X-Spam-Score: 1.5 (+) X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6.x X-Received-From: 140.186.70.43 X-BeenThere: bug-gnu-emacs@gnu.org List-Id: "Bug reports for GNU Emacs, the Swiss army knife of text editors" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Original-Sender: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Xref: news.gmane.org gmane.emacs.bugs:66739 Archived-At: > From: "Drew Adams" > Cc: <12853@debbugs.gnu.org> > Date: Sat, 10 Nov 2012 10:56:04 -0800 > > I'm asking that the doc be corrected and made more clear and > complete. Fine with me. I didn't want to imply that the doc string should not be corrected. I just wanted to explain why unspecified-* "colors" are exceptions, and why they are mentioned in the doc string. > In any case, please make clear here just what is meant by a "defined color" in > this context This is already part of the doc string: Return non-nil if color COLOR is supported on frame FRAME. ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ "Supported" means you can use COLOR in any context where a color is expected, and the display will show that color without signaling an error. > and how that definition relates to those particular noncolor > defined-color exceptions. This would require to delve too deep into the internals, which might not be appropriate for a doc string. > 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). I don't understand why you are looking for a definition, beyond the simple one stated in the doc string, when the function we are talking about, color-defined-p, provides that definition: a "defined color" for the purposes of this function is something for which this function returns a non-nil value.