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#8049: 24.0.50; doc of `list-colors-sort' Date: Tue, 15 Feb 2011 19:37:54 -0800 Message-ID: <2B6966986D2F4B68BF03667532AABF10@us.oracle.com> References: <6BE76CFC25EF457CB7F166586D6C44B3@us.oracle.com> <87pqqsd71w.fsf@mail.jurta.org> NNTP-Posting-Host: lo.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: 7bit X-Trace: dough.gmane.org 1297829204 25771 80.91.229.12 (16 Feb 2011 04:06:44 GMT) X-Complaints-To: usenet@dough.gmane.org NNTP-Posting-Date: Wed, 16 Feb 2011 04:06:44 +0000 (UTC) Cc: 8049@debbugs.gnu.org To: "'Juri Linkov'" Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Wed Feb 16 05:06:40 2011 Return-path: Envelope-to: geb-bug-gnu-emacs@m.gmane.org Original-Received: from lists.gnu.org ([199.232.76.165]) by lo.gmane.org with esmtp (Exim 4.69) (envelope-from ) id 1PpYf1-0001E8-Q6 for geb-bug-gnu-emacs@m.gmane.org; Wed, 16 Feb 2011 05:06:40 +0100 Original-Received: from localhost ([127.0.0.1]:47611 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1PpYf1-00069Y-7V for geb-bug-gnu-emacs@m.gmane.org; Tue, 15 Feb 2011 23:06:39 -0500 Original-Received: from [140.186.70.92] (port=38056 helo=eggs.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1PpYev-00069D-5w for bug-gnu-emacs@gnu.org; Tue, 15 Feb 2011 23:06:34 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1PpYet-0003pJ-T3 for bug-gnu-emacs@gnu.org; Tue, 15 Feb 2011 23:06:33 -0500 Original-Received: from debbugs.gnu.org ([140.186.70.43]:57751) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1PpYet-0003pF-QQ for bug-gnu-emacs@gnu.org; Tue, 15 Feb 2011 23:06:31 -0500 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.69) (envelope-from ) id 1PpY5b-0005xc-QV; Tue, 15 Feb 2011 22:30:03 -0500 X-Loop: help-debbugs@gnu.org 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: Original-Received: via spool by 8049-submit@debbugs.gnu.org id=B8049.129782698522871 (code B ref 8049); Wed, 16 Feb 2011 03:30:03 +0000 Original-Received: (at 8049) by debbugs.gnu.org; 16 Feb 2011 03:29:45 +0000 Original-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 Original-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 Original-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 Original-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 Original-Received: from abhmt004.oracle.com by acsmt355.oracle.com with ESMTP id 1058131831297827479; Tue, 15 Feb 2011 19:37:59 -0800 Original-Received: from dradamslap1 (/10.159.60.234) by default (Oracle Beehive Gateway v4.0) with ESMTP ; Tue, 15 Feb 2011 19:37:58 -0800 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-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.11 Precedence: list Resent-Date: Tue, 15 Feb 2011 22:30:03 -0500 X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6 (newer, 3) 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: , Original-Sender: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Errors-To: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Xref: news.gmane.org gmane.emacs.bugs:44162 Archived-At: > > 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.