From unknown Wed Jul 09 03:54:29 2025 X-Loop: help-debbugs@gnu.org Subject: bug#8049: 24.0.50; doc of `list-colors-sort' Resent-From: "Drew Adams" Original-Sender: debbugs-submit-bounces@debbugs.gnu.org Resent-To: owner@debbugs.gnu.org Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Wed, 16 Feb 2011 01:19:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: report 8049 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: To: 8049@debbugs.gnu.org X-Debbugs-Original-To: Received: via spool by submit@debbugs.gnu.org id=B.129781912711833 (code B ref -1); Wed, 16 Feb 2011 01:19:01 +0000 Received: (at submit) by debbugs.gnu.org; 16 Feb 2011 01:18:47 +0000 Received: from localhost ([127.0.0.1] helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1PpW2Y-00034o-FV for submit@debbugs.gnu.org; Tue, 15 Feb 2011 20:18:46 -0500 Received: from eggs.gnu.org ([140.186.70.92]) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1PpW2X-00034c-39 for submit@debbugs.gnu.org; Tue, 15 Feb 2011 20:18:45 -0500 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1PpWBF-0004Wa-Q0 for submit@debbugs.gnu.org; Tue, 15 Feb 2011 20:27:46 -0500 X-Spam-Checker-Version: SpamAssassin 3.3.1 (2010-03-16) on eggs.gnu.org X-Spam-Level: X-Spam-Status: No, score=-4.2 required=5.0 tests=BAYES_00,RCVD_IN_DNSWL_MED, T_RP_MATCHES_RCVD, UNPARSEABLE_RELAY autolearn=unavailable version=3.3.1 Received: from lists.gnu.org ([199.232.76.165]:50509) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1PpWBF-0004WV-MU for submit@debbugs.gnu.org; Tue, 15 Feb 2011 20:27:45 -0500 Received: from [140.186.70.92] (port=45773 helo=eggs.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1PpWBE-0005Av-32 for bug-gnu-emacs@gnu.org; Tue, 15 Feb 2011 20:27:45 -0500 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1PpWBD-0004Vr-EV for bug-gnu-emacs@gnu.org; Tue, 15 Feb 2011 20:27:44 -0500 Received: from rcsinet10.oracle.com ([148.87.113.121]:65430) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1PpWBD-0004Vd-9B for bug-gnu-emacs@gnu.org; Tue, 15 Feb 2011 20:27:43 -0500 Received: from rcsinet15.oracle.com (rcsinet15.oracle.com [148.87.113.117]) by rcsinet10.oracle.com (Switch-3.4.2/Switch-3.4.2) with ESMTP id p1G1RdLQ011105 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=OK) for ; Wed, 16 Feb 2011 01:27:41 GMT Received: from acsmt354.oracle.com (acsmt354.oracle.com [141.146.40.154]) by rcsinet15.oracle.com (Switch-3.4.2/Switch-3.4.1) with ESMTP id p1G1RbwO024875 for ; Wed, 16 Feb 2011 01:27:37 GMT Received: from abhmt010.oracle.com by acsmt353.oracle.com with ESMTP id 1009367061297819655; Tue, 15 Feb 2011 17:27:35 -0800 Received: from dradamslap1 (/10.159.60.234) by default (Oracle Beehive Gateway v4.0) with ESMTP ; Tue, 15 Feb 2011 17:27:35 -0800 From: "Drew Adams" Date: Tue, 15 Feb 2011 17:27:31 -0800 Message-ID: <6BE76CFC25EF457CB7F166586D6C44B3@us.oracle.com> MIME-Version: 1.0 Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: 7bit X-Mailer: Microsoft Office Outlook 11 Thread-Index: AcvNeK5F8UnuSktpT+yxoe4XsqVUzw== X-MimeOLE: Produced By Microsoft MimeOLE V6.00.2900.5994 X-Source-IP: acsmt354.oracle.com [141.146.40.154] X-Auth-Type: Internal IP X-CT-RefId: str=0001.0A090202.4D5B280B.00BD:SCFMA4539814,ss=1,fgs=0 X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6 (newer, 3) X-Received-From: 148.87.113.121 X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6 (newer, 2) X-Received-From: 199.232.76.165 X-Spam-Score: -6.4 (------) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.11 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Sender: debbugs-submit-bounces@debbugs.gnu.org Errors-To: debbugs-submit-bounces@debbugs.gnu.org X-Spam-Score: -6.4 (------) The doc should explain what is meant by RGB and HSV color distance here. There is not only one possible definition of color distance, and many users will not have a feel for this or prior knowledge about it. There is nothing in either Emacs manual about this, so the doc string needs to cover it. In GNU Emacs 24.0.50.1 (i386-mingw-nt5.1.2600) of 2011-02-14 on 3249CTO Windowing system distributor `Microsoft Corp.', version 5.1.2600 configured using `configure --with-gcc (4.4) --no-opt --cflags -Ic:/imagesupport/include' From unknown Wed Jul 09 03:54:29 2025 X-Loop: help-debbugs@gnu.org Subject: bug#8049: 24.0.50; doc of `list-colors-sort' Resent-From: Juri Linkov Original-Sender: debbugs-submit-bounces@debbugs.gnu.org Resent-To: owner@debbugs.gnu.org Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Wed, 16 Feb 2011 02:56:03 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 8049 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: To: "Drew Adams" Cc: 8049@debbugs.gnu.org Received: via spool by 8049-submit@debbugs.gnu.org id=B8049.129782492119998 (code B ref 8049); Wed, 16 Feb 2011 02:56:03 +0000 Received: (at 8049) by debbugs.gnu.org; 16 Feb 2011 02:55:21 +0000 Received: from localhost ([127.0.0.1] helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1PpXY1-0005CV-3t for submit@debbugs.gnu.org; Tue, 15 Feb 2011 21:55:21 -0500 Received: from smarty.dreamhost.com ([208.113.175.8]) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1PpXXy-0005C0-VU for 8049@debbugs.gnu.org; Tue, 15 Feb 2011 21:55:19 -0500 Received: from ps18281.dreamhostps.com (ps18281.dreamhost.com [69.163.218.105]) by smarty.dreamhost.com (Postfix) with ESMTP id 6A9B26E8069; Tue, 15 Feb 2011 19:04:20 -0800 (PST) Received: from localhost (ps18281.dreamhostps.com [69.163.218.105]) by ps18281.dreamhostps.com (Postfix) with ESMTP id 8B500451C213; Tue, 15 Feb 2011 19:04:19 -0800 (PST) From: Juri Linkov Organization: JURTA References: <6BE76CFC25EF457CB7F166586D6C44B3@us.oracle.com> Date: Wed, 16 Feb 2011 02:43:59 +0200 In-Reply-To: <6BE76CFC25EF457CB7F166586D6C44B3@us.oracle.com> (Drew Adams's message of "Tue, 15 Feb 2011 17:27:31 -0800") Message-ID: <87pqqsd71w.fsf@mail.jurta.org> User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/24.0.50 (x86_64-pc-linux-gnu) MIME-Version: 1.0 Content-Type: text/plain X-Spam-Score: -2.6 (--) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.11 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Sender: debbugs-submit-bounces@debbugs.gnu.org Errors-To: debbugs-submit-bounces@debbugs.gnu.org X-Spam-Score: -2.6 (--) > The doc should explain what is meant by RGB and HSV color distance here. There > is not only one possible definition of color distance, and many users will not > have a feel for this or prior knowledge about it. > > There is nothing in either Emacs manual about this, so the doc string needs to > cover it. There is no detailed explanation in color.el either, so I don't see a need to do this in `list-colors-sort'. From unknown Wed Jul 09 03:54:29 2025 X-Loop: help-debbugs@gnu.org Subject: bug#8049: 24.0.50; doc of `list-colors-sort' Resent-From: "Drew Adams" Original-Sender: debbugs-submit-bounces@debbugs.gnu.org Resent-To: owner@debbugs.gnu.org Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Wed, 16 Feb 2011 03:30:03 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 8049 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: To: "'Juri Linkov'" Cc: 8049@debbugs.gnu.org Received: via spool by 8049-submit@debbugs.gnu.org id=B8049.129782698522871 (code B ref 8049); Wed, 16 Feb 2011 03:30:03 +0000 Received: (at 8049) by debbugs.gnu.org; 16 Feb 2011 03:29:45 +0000 Received: from localhost ([127.0.0.1] helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1PpY5I-0005wq-Hn for submit@debbugs.gnu.org; Tue, 15 Feb 2011 22:29:44 -0500 Received: from rcsinet10.oracle.com ([148.87.113.121]) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1PpY5G-0005wd-O7 for 8049@debbugs.gnu.org; Tue, 15 Feb 2011 22:29:43 -0500 Received: from acsinet15.oracle.com (acsinet15.oracle.com [141.146.126.227]) by rcsinet10.oracle.com (Switch-3.4.2/Switch-3.4.2) with ESMTP id p1G3cfVj011071 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=OK); Wed, 16 Feb 2011 03:38:42 GMT Received: from acsmt354.oracle.com (acsmt354.oracle.com [141.146.40.154]) by acsinet15.oracle.com (Switch-3.4.2/Switch-3.4.1) with ESMTP id p1FMLL6p031463; Wed, 16 Feb 2011 03:38:38 GMT Received: from abhmt004.oracle.com by acsmt355.oracle.com with ESMTP id 1058131831297827479; Tue, 15 Feb 2011 19:37:59 -0800 Received: from dradamslap1 (/10.159.60.234) by default (Oracle Beehive Gateway v4.0) with ESMTP ; Tue, 15 Feb 2011 19:37:58 -0800 From: "Drew Adams" References: <6BE76CFC25EF457CB7F166586D6C44B3@us.oracle.com> <87pqqsd71w.fsf@mail.jurta.org> Date: Tue, 15 Feb 2011 19:37:54 -0800 Message-ID: <2B6966986D2F4B68BF03667532AABF10@us.oracle.com> MIME-Version: 1.0 Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: 7bit X-Mailer: Microsoft Office Outlook 11 In-Reply-To: <87pqqsd71w.fsf@mail.jurta.org> Thread-Index: AcvNhjWsP3gEBdkkRfm66d1qLHTCVAABCoVw X-MimeOLE: Produced By Microsoft MimeOLE V6.00.2900.5994 X-Source-IP: acsmt354.oracle.com [141.146.40.154] X-Auth-Type: Internal IP X-CT-RefId: str=0001.0A090201.4D5B46C0.0096:SCFMA4539814,ss=1,fgs=0 X-Spam-Score: -6.4 (------) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.11 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Sender: debbugs-submit-bounces@debbugs.gnu.org Errors-To: debbugs-submit-bounces@debbugs.gnu.org X-Spam-Score: -6.4 (------) > > The doc should explain what is meant by RGB and HSV color > > distance here. There is not only one possible definition > > of color distance, and many users will not > > have a feel for this or prior knowledge about it. > > > > There is nothing in either Emacs manual about this, so the > > doc string needs to cover it. > > There is no detailed explanation in color.el either, > so I don't see a need to do this in `list-colors-sort'. Huh? Whether the source code explains something users need to know is beside the point. Users are not expected to study the source code (although they are welcome to). This is about a _user option_, not about the source code. And no one said anything about a "detailed" explanation. We give users a choice of behaviors, but we do nothing more than name two of the choices - no real description to let them know what is involved, what to expect, how those choices differ from the others. Users deserve better. From debbugs-submit-bounces@debbugs.gnu.org Thu Jul 14 14:33:21 2011 Received: (at control) by debbugs.gnu.org; 14 Jul 2011 18:33:22 +0000 Received: from localhost ([127.0.0.1] helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1QhQiv-0002Da-Er for submit@debbugs.gnu.org; Thu, 14 Jul 2011 14:33:21 -0400 Received: from hermes.netfonds.no ([80.91.224.195]) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1QhQit-0002DL-VO for control@debbugs.gnu.org; Thu, 14 Jul 2011 14:33:20 -0400 Received: from cm-84.215.51.58.getinternet.no ([84.215.51.58] helo=quimbies.gnus.org) by hermes.netfonds.no with esmtpsa (TLS1.0:DHE_RSA_AES_128_CBC_SHA1:16) (Exim 4.72) (envelope-from ) id 1QhQii-0006Ub-Fo for control@debbugs.gnu.org; Thu, 14 Jul 2011 20:33:08 +0200 Date: Thu, 14 Jul 2011 20:33:07 +0200 Message-Id: To: control@debbugs.gnu.org From: Lars Magne Ingebrigtsen Subject: control message for bug #8049 X-MailScanner-ID: 1QhQii-0006Ub-Fo X-Netfonds-MailScanner: Found to be clean X-Netfonds-MailScanner-From: larsi@gnus.org MailScanner-NULL-Check: 1311273188.64889@rfl6iOj3LofYHLMTcMSwag X-Spam-Status: No X-Spam-Score: -2.7 (--) X-Debbugs-Envelope-To: control X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.11 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Sender: debbugs-submit-bounces@debbugs.gnu.org Errors-To: debbugs-submit-bounces@debbugs.gnu.org X-Spam-Score: -2.7 (--) tags 8049 wontfix close 8049 From unknown Wed Jul 09 03:54:29 2025 X-Loop: help-debbugs@gnu.org Subject: bug#8049: 24.0.50; doc of `list-colors-sort' Resent-From: Lars Magne Ingebrigtsen Original-Sender: debbugs-submit-bounces@debbugs.gnu.org Resent-To: owner@debbugs.gnu.org Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Thu, 14 Jul 2011 18:48:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 8049 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: wontfix To: "Drew Adams" Cc: 8049@debbugs.gnu.org Received: via spool by 8049-submit@debbugs.gnu.org id=B8049.131066923813289 (code B ref 8049); Thu, 14 Jul 2011 18:48:02 +0000 Received: (at 8049) by debbugs.gnu.org; 14 Jul 2011 18:47:18 +0000 Received: from localhost ([127.0.0.1] helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1QhQwO-0003S5-4x for submit@debbugs.gnu.org; Thu, 14 Jul 2011 14:47:16 -0400 Received: from hermes.netfonds.no ([80.91.224.195]) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1QhQwJ-0003RM-6T for 8049@debbugs.gnu.org; Thu, 14 Jul 2011 14:47:11 -0400 Received: from cm-84.215.51.58.getinternet.no ([84.215.51.58] helo=quimbies.gnus.org) by hermes.netfonds.no with esmtpsa (TLS1.0:DHE_RSA_AES_128_CBC_SHA1:16) (Exim 4.72) (envelope-from ) id 1QhQw6-0006iC-2v; Thu, 14 Jul 2011 20:46:58 +0200 From: Lars Magne Ingebrigtsen In-Reply-To: <6BE76CFC25EF457CB7F166586D6C44B3@us.oracle.com> (Drew Adams's message of "Tue, 15 Feb 2011 17:27:31 -0800") Date: Thu, 14 Jul 2011 20:32:58 +0200 Message-ID: References: <6BE76CFC25EF457CB7F166586D6C44B3@us.oracle.com> User-Agent: Gnus/5.110018 (No Gnus v0.18) Emacs/24.0.50 (gnu/linux) X-Now-Playing: Joni Mitchell's _Don Juan's Reckless Daughter_: "Overture -- Cotton Avenue" X-Hashcash: 1:23:110714:8049@debbugs.gnu.org::Dmw0SFSji2FEMk3A:00000000000000000000000000000000000000000PdQp X-Hashcash: 1:23:110714:drew.adams@oracle.com::k5haOl8OjBWu46Ud:0000000000000000000000000000000000000000SA3p MIME-Version: 1.0 Content-Type: text/plain X-MailScanner-ID: 1QhQw6-0006iC-2v X-Netfonds-MailScanner: Found to be clean X-Netfonds-MailScanner-From: larsi@gnus.org MailScanner-NULL-Check: 1311274018.27766@lVvg4IPZ+psjd0Jng+mX7Q X-Spam-Status: No X-Spam-Score: -2.7 (--) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.11 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Sender: debbugs-submit-bounces@debbugs.gnu.org Errors-To: debbugs-submit-bounces@debbugs.gnu.org X-Spam-Score: -2.7 (--) "Drew Adams" writes: > The doc should explain what is meant by RGB and HSV color distance here. There > is not only one possible definition of color distance, and many users will not > have a feel for this or prior knowledge about it. Explaining the details of RGB and HSV colour distances is way, way outside the scope of a doc string, so I'm closing this report. -- (domestic pets only, the antidote for overdose, milk.) bloggy blog http://lars.ingebrigtsen.no/