From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!.POSTED.blaine.gmane.org!not-for-mail From: Drew Adams Newsgroups: gmane.emacs.bugs Subject: bug#38183: 26.3; Doc about equality of markers Date: Tue, 12 Nov 2019 11:03:20 -0800 (PST) Message-ID: <104e3572-fe9c-42b8-a099-769389ff1588@default> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Transfer-Encoding: quoted-printable Injection-Info: blaine.gmane.org; posting-host="blaine.gmane.org:195.159.176.226"; logging-data="124737"; mail-complaints-to="usenet@blaine.gmane.org" To: 38183@debbugs.gnu.org Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Tue Nov 12 20:04:11 2019 Return-path: Envelope-to: geb-bug-gnu-emacs@m.gmane.org Original-Received: from lists.gnu.org ([209.51.188.17]) by blaine.gmane.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.89) (envelope-from ) id 1iUbSU-000WL1-Cv for geb-bug-gnu-emacs@m.gmane.org; Tue, 12 Nov 2019 20:04:10 +0100 Original-Received: from localhost ([::1]:39034 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1iUbST-00088M-8e for geb-bug-gnu-emacs@m.gmane.org; Tue, 12 Nov 2019 14:04:09 -0500 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:44719) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1iUbSN-000884-9C for bug-gnu-emacs@gnu.org; Tue, 12 Nov 2019 14:04:04 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1iUbSM-0007On-7g for bug-gnu-emacs@gnu.org; Tue, 12 Nov 2019 14:04:03 -0500 Original-Received: from debbugs.gnu.org ([209.51.188.43]:49560) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1iUbSM-0007Od-3y for bug-gnu-emacs@gnu.org; Tue, 12 Nov 2019 14:04:02 -0500 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1iUbSL-0007iX-So for bug-gnu-emacs@gnu.org; Tue, 12 Nov 2019 14:04: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: Tue, 12 Nov 2019 19:04:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: report 38183 X-GNU-PR-Package: emacs X-Debbugs-Original-To: bug-gnu-emacs@gnu.org Original-Received: via spool by submit@debbugs.gnu.org id=B.157358541229605 (code B ref -1); Tue, 12 Nov 2019 19:04:01 +0000 Original-Received: (at submit) by debbugs.gnu.org; 12 Nov 2019 19:03:32 +0000 Original-Received: from localhost ([127.0.0.1]:58381 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1iUbRs-0007hP-DZ for submit@debbugs.gnu.org; Tue, 12 Nov 2019 14:03:32 -0500 Original-Received: from lists.gnu.org ([209.51.188.17]:32814) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1iUbRr-0007hI-7B for submit@debbugs.gnu.org; Tue, 12 Nov 2019 14:03:31 -0500 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:44672) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1iUbRq-0007yf-23 for bug-gnu-emacs@gnu.org; Tue, 12 Nov 2019 14:03:31 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1iUbRo-0007DE-L0 for bug-gnu-emacs@gnu.org; Tue, 12 Nov 2019 14:03:29 -0500 Original-Received: from aserp2120.oracle.com ([141.146.126.78]:49124) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_256_CBC_SHA1:32) (Exim 4.71) (envelope-from ) id 1iUbRo-0007CY-Bo for bug-gnu-emacs@gnu.org; Tue, 12 Nov 2019 14:03:28 -0500 Original-Received: from pps.filterd (aserp2120.oracle.com [127.0.0.1]) by aserp2120.oracle.com (8.16.0.27/8.16.0.27) with SMTP id xACIo83x088817 for ; Tue, 12 Nov 2019 19:03:22 GMT DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=oracle.com; h=mime-version : message-id : date : from : sender : to : subject : content-type : content-transfer-encoding; s=corp-2019-08-05; bh=TyziuuoCBCVIY8kbSCtObg5HfH2WF+0Oxg4qvAZmiks=; b=e9CKcrV+IivY9vRZJqp9H0vu8ic5OMiwhlNuSef2UeAUETmCXyX4Cf/wlACSwyQ2GlLw DyEXrdn4f1ORzoOQNha6vMy824kPvrNtzd8gKQ/cSMgVZLhkgSTKaUNU+Cjhuf7wqdbI NWcX812pOmroJhOo6cWTQs0/BwlwYMWqNQqGYVGKlGwGy1tStWvFxRtVFo/48O2KU+bS bESR3nO30QRdKn3LoZBHCtz9r7kH1pRdlZrByD/Q9L2Km+mxdNN8S9NJKz6LIvqMBtz8 jMaOFn1Ll4+G4qIPzTlNFXZ7vkGs1/XngL+DVXoCbryfSUCIIAKiAbOpxNtgQidwjIme lg== Original-Received: from aserp3020.oracle.com (aserp3020.oracle.com [141.146.126.70]) by aserp2120.oracle.com with ESMTP id 2w5ndq6ymk-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK) for ; Tue, 12 Nov 2019 19:03:22 +0000 Original-Received: from pps.filterd (aserp3020.oracle.com [127.0.0.1]) by aserp3020.oracle.com (8.16.0.27/8.16.0.27) with SMTP id xACImftm186481 for ; Tue, 12 Nov 2019 19:03:22 GMT Original-Received: from userv0122.oracle.com (userv0122.oracle.com [156.151.31.75]) by aserp3020.oracle.com with ESMTP id 2w7j02a1xn-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK) for ; Tue, 12 Nov 2019 19:03:22 +0000 Original-Received: from abhmp0018.oracle.com (abhmp0018.oracle.com [141.146.116.24]) by userv0122.oracle.com (8.14.4/8.14.4) with ESMTP id xACJ3KsD005841 for ; Tue, 12 Nov 2019 19:03:21 GMT X-Priority: 3 X-Mailer: Oracle Beehive Extensions for Outlook 2.0.1.9.1 (1003210) [OL 16.0.4900.0 (x86)] X-Proofpoint-Virus-Version: vendor=nai engine=6000 definitions=9439 signatures=668685 X-Proofpoint-Spam-Details: rule=notspam policy=default score=0 suspectscore=1 malwarescore=0 phishscore=0 bulkscore=0 spamscore=0 mlxscore=0 mlxlogscore=847 adultscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.0.1-1910280000 definitions=main-1911120160 X-Proofpoint-Virus-Version: vendor=nai engine=6000 definitions=9439 signatures=668685 X-Proofpoint-Spam-Details: rule=notspam policy=default score=0 priorityscore=1501 malwarescore=0 suspectscore=1 phishscore=0 bulkscore=0 spamscore=0 clxscore=1031 lowpriorityscore=0 mlxscore=0 impostorscore=0 mlxlogscore=916 adultscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.0.1-1910280000 definitions=main-1911120160 X-detected-operating-system: by eggs.gnu.org: GNU/Linux 3.x [generic] [fuzzy] 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: 209.51.188.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" Xref: news.gmane.org gmane.emacs.bugs:171464 Archived-At: I think the doc about equality of markers should be improved. In the Elisp manual: Nodes `Equality Predicates' and `Overview of Markers' point out _one_ difference between `eq' and `equal', for markers. But in both of these nodes the examples and explanations involve only markers for the same buffer. In node `Creating Markers' we finally find get the information that `equal' requires the markers to also be for the same buffer. But again, the examples there show only markers for the same buffer. There should be an example with `equal' for markers with same numerical value but for different buffers. Node `Comparison of Numbers' tells us how to compare markers only with respect to their numerical values, i.e., to ignore a buffer difference. This info should be brought together, so that wherever we speak of equality tests for markers we can learn that (1) `eq' requires the markers to be identical (the same marker object), (2) `equal' requires them to have the same numerical value and be for the same buffer, and (3) `=3D' requires them to just have the same numerical value. At the very least, all of that info should be available in one place, in the section about markers. And it should include simple examples (like now, but including `=3D' and the case of `equal' for two markers with the same numerical value but for different buffers). I think the info belongs in `Overview of Markers'. (But it could logically be in `Predicates on Markers'.) In particular, this is not something that's particular to `Creating Markers'. IMO you could remove the examples of this kind of thing from the description of `copy-marker'. But if duplication is OK then it's OK to repeat it there. The point is that that shouldn't be the only place to find this info. In GNU Emacs 26.3 (build 1, x86_64-w64-mingw32) of 2019-08-29 Repository revision: 96dd0196c28bc36779584e47fffcca433c9309cd Windowing system distributor `Microsoft Corp.', version 10.0.17763 Configured using: `configure --without-dbus --host=3Dx86_64-w64-mingw32 --without-compress-install 'CFLAGS=3D-O2 -static -g3''