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#8353: 24.0.50; Header of *Apropos* buffer needs to explain `(SCORE)' Date: Mon, 10 Feb 2014 10:40:08 -0800 (PST) Message-ID: <48a43024-02b7-4f03-992a-e78843a64fae@default> References: <87fvns7p8e.fsf@building.gnus.org> NNTP-Posting-Host: plane.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Transfer-Encoding: quoted-printable X-Trace: ger.gmane.org 1392065153 2936 80.91.229.3 (10 Feb 2014 20:45:53 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Mon, 10 Feb 2014 20:45:53 +0000 (UTC) Cc: 8353@debbugs.gnu.org To: Lars Ingebrigtsen Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Mon Feb 10 21:46:00 2014 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 1WCxjr-0004Vb-Hr for geb-bug-gnu-emacs@m.gmane.org; Mon, 10 Feb 2014 21:45:59 +0100 Original-Received: from localhost ([::1]:58104 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1WCxjq-0004g7-WD for geb-bug-gnu-emacs@m.gmane.org; Mon, 10 Feb 2014 15:45:59 -0500 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:53070) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1WCvn6-0000u3-7p for bug-gnu-emacs@gnu.org; Mon, 10 Feb 2014 13:41:20 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1WCvmx-0007Cr-Kp for bug-gnu-emacs@gnu.org; Mon, 10 Feb 2014 13:41:12 -0500 Original-Received: from debbugs.gnu.org ([140.186.70.43]:33823) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1WCvmx-0007Cn-EP for bug-gnu-emacs@gnu.org; Mon, 10 Feb 2014 13:41:03 -0500 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.80) (envelope-from ) id 1WCvmx-0000Ck-6m for bug-gnu-emacs@gnu.org; Mon, 10 Feb 2014 13:41:03 -0500 X-Loop: help-debbugs@gnu.org Resent-From: Drew Adams Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Mon, 10 Feb 2014 18:41:03 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 8353 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: wontfix Original-Received: via spool by 8353-submit@debbugs.gnu.org id=B8353.1392057624710 (code B ref 8353); Mon, 10 Feb 2014 18:41:03 +0000 Original-Received: (at 8353) by debbugs.gnu.org; 10 Feb 2014 18:40:24 +0000 Original-Received: from localhost ([127.0.0.1]:41714 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1WCvmI-0000BL-PT for submit@debbugs.gnu.org; Mon, 10 Feb 2014 13:40:23 -0500 Original-Received: from userp1040.oracle.com ([156.151.31.81]:32538) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1WCvmG-0000Az-J5 for 8353@debbugs.gnu.org; Mon, 10 Feb 2014 13:40:21 -0500 Original-Received: from acsinet22.oracle.com (acsinet22.oracle.com [141.146.126.238]) by userp1040.oracle.com (Sentrion-MTA-4.3.2/Sentrion-MTA-4.3.2) with ESMTP id s1AIeCPU001693 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=OK); Mon, 10 Feb 2014 18:40:13 GMT Original-Received: from userz7021.oracle.com (userz7021.oracle.com [156.151.31.85]) by acsinet22.oracle.com (8.14.4+Sun/8.14.4) with ESMTP id s1AIeAcC003695 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=FAIL); Mon, 10 Feb 2014 18:40:11 GMT Original-Received: from abhmp0015.oracle.com (abhmp0015.oracle.com [141.146.116.21]) by userz7021.oracle.com (8.14.4+Sun/8.14.4) with ESMTP id s1AIe9tB006446; Mon, 10 Feb 2014 18:40:09 GMT In-Reply-To: <87fvns7p8e.fsf@building.gnus.org> X-Priority: 3 X-Mailer: Oracle Beehive Extensions for Outlook 2.0.1.8 (707110) [OL 12.0.6680.5000 (x86)] X-Source-IP: acsinet22.oracle.com [141.146.126.238] X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.15 Precedence: list X-detected-operating-system: by eggs.gnu.org: GNU/Linux 3.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:85313 Archived-At: > > (setq apropos-sort-by-scores 'verbose) > > > > C-h a forward buffer char RET > > > > The buffer header needs to explain what the parenthesized numbers > > mean, e.g. (804). First, explain that these are scores. >=20 > The documentation of the variable says that scores are displayed, so > I don't think it's necessary to say that. Users do not necessarily see the variable or know anything about it! This is about the apropos output buffer. We show them a number in parens, without saying anything about what it means. That is really bad user interface etiquette. If this is not supposed to be meaningful to users then REMOVE it from the UI - don't show the scores. If showing this is supposed to help users, then let them know what these numbers mean. This should be a no-brainer. > > Second, explain what they mean and how hits are scored. >=20 > I think that's pretty irrelevant. Then remove them. If you show them to users then introduce/explain them. > I think everybody understands that higher scores are "better". If that were the case there there would be NO need for this variable and NO need to show the scores. The fact that we let users sort differently shows that scores are meaningful and=20 higher is not necessarily better, in terms of what the user is looking for or how s?he wants the hits presented. > And the way the score is derived is liable to change. Then the info describing the feature would be updated=20 accordingly. You cannot just throw something like this out there in a UI and offer no information about what it is.