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: Fri, 8 Jan 2016 13:29:42 -0800 (PST) Message-ID: <392e6417-fc8f-46a9-85b2-39d22a90f90e@default> 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>> 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 1452288631 20266 80.91.229.3 (8 Jan 2016 21:30:31 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Fri, 8 Jan 2016 21:30:31 +0000 (UTC) Cc: 22314@debbugs.gnu.org To: Eli Zaretskii , Drew Adams Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Fri Jan 08 22:30:18 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 1aHebq-0007Ur-Mx for geb-bug-gnu-emacs@m.gmane.org; Fri, 08 Jan 2016 22:30:10 +0100 Original-Received: from localhost ([::1]:38165 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1aHebp-0001On-VC for geb-bug-gnu-emacs@m.gmane.org; Fri, 08 Jan 2016 16:30:09 -0500 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:50745) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1aHebm-0001OT-BO for bug-gnu-emacs@gnu.org; Fri, 08 Jan 2016 16:30:07 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1aHebj-0002Lc-2Q for bug-gnu-emacs@gnu.org; Fri, 08 Jan 2016 16:30:06 -0500 Original-Received: from debbugs.gnu.org ([208.118.235.43]:55242) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1aHebi-0002LA-Vu for bug-gnu-emacs@gnu.org; Fri, 08 Jan 2016 16:30:03 -0500 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84) (envelope-from ) id 1aHebi-00040C-PV for bug-gnu-emacs@gnu.org; Fri, 08 Jan 2016 16:30:02 -0500 X-Loop: help-debbugs@gnu.org Resent-From: Drew Adams Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Fri, 08 Jan 2016 21:30:02 +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-submit@debbugs.gnu.org id=B22314.145228859315343 (code B ref 22314); Fri, 08 Jan 2016 21:30:02 +0000 Original-Received: (at 22314) by debbugs.gnu.org; 8 Jan 2016 21:29:53 +0000 Original-Received: from localhost ([127.0.0.1]:43462 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84) (envelope-from ) id 1aHebY-0003zP-Tu for submit@debbugs.gnu.org; Fri, 08 Jan 2016 16:29:53 -0500 Original-Received: from userp1040.oracle.com ([156.151.31.81]:35748) by debbugs.gnu.org with esmtp (Exim 4.84) (envelope-from ) id 1aHebX-0003zC-7d for 22314@debbugs.gnu.org; Fri, 08 Jan 2016 16:29:51 -0500 Original-Received: from aserv0022.oracle.com (aserv0022.oracle.com [141.146.126.234]) by userp1040.oracle.com (Sentrion-MTA-4.3.2/Sentrion-MTA-4.3.2) with ESMTP id u08LTieR001298 (version=TLSv1 cipher=DHE-RSA-AES256-SHA bits=256 verify=FAIL); Fri, 8 Jan 2016 21:29:45 GMT Original-Received: from aserv0121.oracle.com (aserv0121.oracle.com [141.146.126.235]) by aserv0022.oracle.com (8.13.8/8.13.8) with ESMTP id u08LThwV004227 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=FAIL); Fri, 8 Jan 2016 21:29:44 GMT Original-Received: from abhmp0019.oracle.com (abhmp0019.oracle.com [141.146.116.25]) by aserv0121.oracle.com (8.13.8/8.13.8) with ESMTP id u08LThp2019752; Fri, 8 Jan 2016 21:29:43 GMT In-Reply-To: <<8337u7q46w.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:111396 Archived-At: > > I think you are. At least for me, with the latest Emacs 25 > > snapshot I have (2015/12/10), `i deactivate-mark' shows two > > index entries, and `,' bounces between them. They are: > > (1) deactivate-mark, the function, and (2) deactivate-mark-hook, > > a variable. Variable `deactivate-mark' is not one of them. > > > > Do you really see something different? >=20 > I see the same, but I don't understand why that is a problem. The > function and the variable are described one after the other, and 'i' > puts you on the first of them with the second clearly visible below. > How is that a problem? And how is it worse than having 2 identical > index entries instead, which point each one to a place several lines > apart? 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. Whether you might happen to have the 3rd visible in the same window (and you might not, depending on your window size), you might well not notice it there - as I did not. 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. 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? 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. 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.