From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: "Drew Adams" Newsgroups: gmane.emacs.bugs Subject: bug#12853: 24.2.50; doc of `color-defined-p' Date: Sat, 10 Nov 2012 10:56:04 -0800 Message-ID: References: <10495ABA26F14041A1E374AC3B820F6E@us.oracle.com> <83d2zlxs8g.fsf@gnu.org> <7DA4A38C21E342A8A4061EC7D8257556@us.oracle.com> <83bof5xq8m.fsf@gnu.org> NNTP-Posting-Host: plane.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: 7bit X-Trace: ger.gmane.org 1352573816 22020 80.91.229.3 (10 Nov 2012 18:56:56 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Sat, 10 Nov 2012 18:56:56 +0000 (UTC) Cc: 12853@debbugs.gnu.org To: "'Eli Zaretskii'" Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Sat Nov 10 19:57:06 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 1TXGEr-0000wl-76 for geb-bug-gnu-emacs@m.gmane.org; Sat, 10 Nov 2012 19:57:05 +0100 Original-Received: from localhost ([::1]:36470 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1TXGEh-0001xj-UM for geb-bug-gnu-emacs@m.gmane.org; Sat, 10 Nov 2012 13:56:55 -0500 Original-Received: from eggs.gnu.org ([208.118.235.92]:59732) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1TXGEd-0001xR-51 for bug-gnu-emacs@gnu.org; Sat, 10 Nov 2012 13:56:54 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1TXGEa-00048f-3O for bug-gnu-emacs@gnu.org; Sat, 10 Nov 2012 13:56:51 -0500 Original-Received: from debbugs.gnu.org ([140.186.70.43]:49594) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1TXGEZ-00048b-Vw for bug-gnu-emacs@gnu.org; Sat, 10 Nov 2012 13:56:48 -0500 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.72) (envelope-from ) id 1TXGEn-0005M9-O2 for bug-gnu-emacs@gnu.org; Sat, 10 Nov 2012 13:57:01 -0500 X-Loop: help-debbugs@gnu.org Resent-From: "Drew Adams" Original-Sender: debbugs-submit-bounces@debbugs.gnu.org Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Sat, 10 Nov 2012 18:57:01 +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.135257379120508 (code B ref 12853); Sat, 10 Nov 2012 18:57:01 +0000 Original-Received: (at 12853) by debbugs.gnu.org; 10 Nov 2012 18:56:31 +0000 Original-Received: from localhost ([127.0.0.1]:59845 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1TXGEI-0005Kg-8G for submit@debbugs.gnu.org; Sat, 10 Nov 2012 13:56:31 -0500 Original-Received: from aserp1040.oracle.com ([141.146.126.69]:39048) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1TXGEF-0005KV-Pd for 12853@debbugs.gnu.org; Sat, 10 Nov 2012 13:56:28 -0500 Original-Received: from acsinet21.oracle.com (acsinet21.oracle.com [141.146.126.237]) by aserp1040.oracle.com (Sentrion-MTA-4.2.2/Sentrion-MTA-4.2.2) with ESMTP id qAAIuCfT007061 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=OK); Sat, 10 Nov 2012 18:56:12 GMT Original-Received: from acsmt357.oracle.com (acsmt357.oracle.com [141.146.40.157]) by acsinet21.oracle.com (8.14.4+Sun/8.14.4) with ESMTP id qAAIuBJ3001910 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=NO); Sat, 10 Nov 2012 18:56:11 GMT Original-Received: from abhmt119.oracle.com (abhmt119.oracle.com [141.146.116.71]) by acsmt357.oracle.com (8.12.11.20060308/8.12.11) with ESMTP id qAAIuBAu016568; Sat, 10 Nov 2012 12:56:11 -0600 Original-Received: from dradamslap1 (/71.202.147.44) by default (Oracle Beehive Gateway v4.0) with ESMTP ; Sat, 10 Nov 2012 10:56:10 -0800 X-Mailer: Microsoft Office Outlook 11 In-reply-to: <83bof5xq8m.fsf@gnu.org> Thread-Index: Ac2/cdPYxRTlKgQxTI6RhJpEl6lwtgAAa1EA X-MimeOLE: Produced By Microsoft MimeOLE V6.00.2900.6157 X-Source-IP: acsinet21.oracle.com [141.146.126.237] X-Spam-Score: 0.4 (/) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.13 Precedence: list X-Spam-Score: 0.4 (/) 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:66737 Archived-At: > 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).