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#22314: 25.1.50; Document variable `deactivate-mark' in Elisp manual Date: Sat, 9 Jan 2016 10:52:38 -0800 (PST) Message-ID: References: <<<<<88046cae-d0e4-4108-b655-5ed142ea97f7@default>>>>> <<<<<83fuyb50jl.fsf@gnu.org>>>>> <<<>>> <<<<2d847088-3f43-4771-9178-4c51081da5d5@default>>>> <<<<83oacwpcrn.fsf@gnu.org>>>> <<>> <<<8337u7q46w.fsf@gnu.org>>> <<392e6417-fc8f-46a9-85b2-39d22a90f90e@default>> <<83wprjnt7i.fsf@gnu.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 1452365607 1936 80.91.229.3 (9 Jan 2016 18:53:27 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Sat, 9 Jan 2016 18:53:27 +0000 (UTC) Cc: 22314-done@debbugs.gnu.org To: Eli Zaretskii , Drew Adams Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Sat Jan 09 19:53:13 2016 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 1aHydU-0001bf-RU for geb-bug-gnu-emacs@m.gmane.org; Sat, 09 Jan 2016 19:53:13 +0100 Original-Received: from localhost ([::1]:42238 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1aHydU-0004J6-B8 for geb-bug-gnu-emacs@m.gmane.org; Sat, 09 Jan 2016 13:53:12 -0500 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:45599) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1aHydP-0004Iy-2Z for bug-gnu-emacs@gnu.org; Sat, 09 Jan 2016 13:53:08 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1aHydK-0003Or-09 for bug-gnu-emacs@gnu.org; Sat, 09 Jan 2016 13:53:06 -0500 Original-Received: from debbugs.gnu.org ([208.118.235.43]:56399) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1aHydJ-0003On-Si for bug-gnu-emacs@gnu.org; Sat, 09 Jan 2016 13:53:01 -0500 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84) (envelope-from ) id 1aHydJ-0006yS-L1 for bug-gnu-emacs@gnu.org; Sat, 09 Jan 2016 13:53:01 -0500 X-Loop: help-debbugs@gnu.org Resent-From: Drew Adams Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Sat, 09 Jan 2016 18:53:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 22314 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: Original-Received: via spool by 22314-done@debbugs.gnu.org id=D22314.145236556826789 (code D ref 22314); Sat, 09 Jan 2016 18:53:01 +0000 Original-Received: (at 22314-done) by debbugs.gnu.org; 9 Jan 2016 18:52:48 +0000 Original-Received: from localhost ([127.0.0.1]:44619 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84) (envelope-from ) id 1aHyd6-0006y1-HJ for submit@debbugs.gnu.org; Sat, 09 Jan 2016 13:52:48 -0500 Original-Received: from aserp1040.oracle.com ([141.146.126.69]:31061) by debbugs.gnu.org with esmtp (Exim 4.84) (envelope-from ) id 1aHyd5-0006xo-5F for 22314-done@debbugs.gnu.org; Sat, 09 Jan 2016 13:52:47 -0500 Original-Received: from aserv0022.oracle.com (aserv0022.oracle.com [141.146.126.234]) by aserp1040.oracle.com (Sentrion-MTA-4.3.2/Sentrion-MTA-4.3.2) with ESMTP id u09IqdNk006669 (version=TLSv1 cipher=DHE-RSA-AES256-SHA bits=256 verify=FAIL); Sat, 9 Jan 2016 18:52:40 GMT Original-Received: from userv0121.oracle.com (userv0121.oracle.com [156.151.31.72]) by aserv0022.oracle.com (8.13.8/8.13.8) with ESMTP id u09Iqd6P013811 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=FAIL); Sat, 9 Jan 2016 18:52:39 GMT Original-Received: from abhmp0003.oracle.com (abhmp0003.oracle.com [141.146.116.9]) by userv0121.oracle.com (8.13.8/8.13.8) with ESMTP id u09IqcAM000398; Sat, 9 Jan 2016 18:52:39 GMT In-Reply-To: <<83wprjnt7i.fsf@gnu.org>> X-Priority: 3 X-Mailer: Oracle Beehive Extensions for Outlook 2.0.1.9 (901082) [OL 12.0.6691.5000 (x86)] X-Source-IP: aserv0022.oracle.com [141.146.126.234] X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] X-Received-From: 208.118.235.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:111436 Archived-At: > > It's wrong because it does not move point to the entry. Nothing > > indicates to a user that there in fact 3 entries, not 2. >=20 > The user's eyes should indicate that. You are splitting hair. No, the echoed message that says there are a total of 2 entries should indicate the number of entries. And hitting `,' should move point to each entry in turn. > > I would not have filed this bug report if I thought that this > > was not a problem. And as you can see from my initial report, > > I in fact mistakenly thought that the variable was not even > > documented, because cycling among the index entries did not > > take me to it. >=20 > You should have read a bit more than a single line. Eli, you can say "you should" all you want. A user (I) reported the problem. If this is a problem for me to find the (non-existent) index entry then it can be a problem for others. Ignore it if you like. > > I don't see why you wouldn't want to add an index entry for this > > variable. But if you don't feel like it then what can I say? >=20 > THERE IS ALREADY AN INDEX ENTRY FOR IT!!!! >=20 > How many times do I need to tell you that? Just look at the sources! Why are you shouting? Whatever you might see in the sources, what concerns me is what a user sees - the observable behavior. Observably the is only one index entry for `deactivate-mark'. Looking in the index itself shows me that there is a single entry for `deactivate-mark'. The echo-area message that gives the total number of matching entries tells me that there is only one entry for `deactivate-mark' (the total shown is 2 entries, and the other one is for `deactivate-mark-hook'). And cycling with `,' moves only between those two entries, never to a variable entry (that your shouting insists exists) for `deactivate-mark'. > > If the Elisp manual had different indexes, as does the Emacs > > manual, then adding it would also let a user find it in the > > Variables Index. >=20 > The function is indexed as a function, the variable is indexed as a > variable. We have @defvar for the variable, which indexes the > variable, and a @defun for the function, which indexes the function. So why is there only one entry for `deactivate-mark' in the Index? And why is there only one entry for it when you use `,' to cycle among all entries? And why does the echo message tell you that there are only 2 entries (the ones you visit when cycling, neither of which is for this variable)? (I don't want to presume anything, but are you sure you are not mistaking the existing index entry for variable `deactivate-mark-hook' for an entry for variable `deactivate-mark'?) > > Maybe it's not possible to index both, if there is only one > > Index? Dunno. If you can't, you can't. If you can (maybe two > > entries, with suffixes "(variable)" and "(function)"), that's > > better, IMO. >=20 > Bug closed. Feel better now?