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: Fri, 15 Nov 2019 09:26:45 -0800 (PST) Message-ID: References: <<104e3572-fe9c-42b8-a099-769389ff1588@default>> <<83eey92s7m.fsf@gnu.org>> 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="90309"; mail-complaints-to="usenet@blaine.gmane.org" Cc: 38183@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 Nov 15 18:29:16 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 1iVfPE-000NGh-Bn for geb-bug-gnu-emacs@m.gmane.org; Fri, 15 Nov 2019 18:29:12 +0100 Original-Received: from localhost ([::1]:42502 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1iVfPC-0006SV-E8 for geb-bug-gnu-emacs@m.gmane.org; Fri, 15 Nov 2019 12:29:10 -0500 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:33762) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1iVfP6-0006RK-0l for bug-gnu-emacs@gnu.org; Fri, 15 Nov 2019 12:29:05 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1iVfP3-0001bC-SZ for bug-gnu-emacs@gnu.org; Fri, 15 Nov 2019 12:29:03 -0500 Original-Received: from debbugs.gnu.org ([209.51.188.43]:56728) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1iVfP3-0001b4-PK for bug-gnu-emacs@gnu.org; Fri, 15 Nov 2019 12:29:01 -0500 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1iVfP3-0002R4-Km for bug-gnu-emacs@gnu.org; Fri, 15 Nov 2019 12:29: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: Fri, 15 Nov 2019 17:29:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 38183 X-GNU-PR-Package: emacs Original-Received: via spool by 38183-submit@debbugs.gnu.org id=B38183.15738389399353 (code B ref 38183); Fri, 15 Nov 2019 17:29:01 +0000 Original-Received: (at 38183) by debbugs.gnu.org; 15 Nov 2019 17:28:59 +0000 Original-Received: from localhost ([127.0.0.1]:37316 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1iVfP0-0002Ql-BB for submit@debbugs.gnu.org; Fri, 15 Nov 2019 12:28:58 -0500 Original-Received: from aserp2120.oracle.com ([141.146.126.78]:49830) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1iVfOy-0002QY-1n for 38183@debbugs.gnu.org; Fri, 15 Nov 2019 12:28:56 -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 xAFHNxat003382; Fri, 15 Nov 2019 17:28:49 GMT DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=oracle.com; h=mime-version : message-id : date : from : sender : to : cc : subject : references : in-reply-to : content-type : content-transfer-encoding; s=corp-2019-08-05; bh=7rLTdRincM4uCvgGnaa8Cpegxp+eN7OQVdDIJFoLlFA=; b=DJMibuQJNpuJNJl8MwxB5IHECUWkD9zj/LGx0Fv4Lgxv9WiuqO57x0e+KPGybsVtldFB XEbX2iQiRS2YnBY1fDyBijuvH0fJIhk6/QDL7f0+bh+9EDlBv11WSeAuvOY1OJ+jtZ28 /PN3QYz5BYo7idcnZaNWB5O9Hwh5YKPA3d0DEFwnM26gKQgQYX+c1bYB5AxwTWAlW7f7 52WGsLG/CLszCWuRh08bhM7WqenuvskseB1pYu7B/MH8wRjyVtBqq10sWHW/li73tVL/ L0C3cPP5GVtEX3QIk9Ky2ZcEZvQv+DW2dgG/NoAQMPCy6BSrQYFQbKHQXKdNeI92JeLS kA== Original-Received: from userp3020.oracle.com (userp3020.oracle.com [156.151.31.79]) by aserp2120.oracle.com with ESMTP id 2w9gxpmjch-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK); Fri, 15 Nov 2019 17:28:49 +0000 Original-Received: from pps.filterd (userp3020.oracle.com [127.0.0.1]) by userp3020.oracle.com (8.16.0.27/8.16.0.27) with SMTP id xAFHJHuo142438; Fri, 15 Nov 2019 17:26:48 GMT Original-Received: from userv0122.oracle.com (userv0122.oracle.com [156.151.31.75]) by userp3020.oracle.com with ESMTP id 2w9h18c885-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK); Fri, 15 Nov 2019 17:26:48 +0000 Original-Received: from abhmp0004.oracle.com (abhmp0004.oracle.com [141.146.116.10]) by userv0122.oracle.com (8.14.4/8.14.4) with ESMTP id xAFHQkfY027427; Fri, 15 Nov 2019 17:26:48 GMT In-Reply-To: <<83eey92s7m.fsf@gnu.org>> X-Priority: 3 X-Mailer: Oracle Beehive Extensions for Outlook 2.0.1.9.1 (1003210) [OL 16.0.4927.0 (x86)] X-Proofpoint-Virus-Version: vendor=nai engine=6000 definitions=9442 signatures=668685 X-Proofpoint-Spam-Details: rule=notspam policy=default score=0 suspectscore=0 malwarescore=0 phishscore=0 bulkscore=0 spamscore=0 mlxscore=0 mlxlogscore=634 adultscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.0.1-1911140001 definitions=main-1911150154 X-Proofpoint-Virus-Version: vendor=nai engine=6000 definitions=9442 signatures=668685 X-Proofpoint-Spam-Details: rule=notspam policy=default score=0 priorityscore=1501 malwarescore=0 suspectscore=0 phishscore=0 bulkscore=0 spamscore=0 clxscore=1011 lowpriorityscore=0 mlxscore=0 impostorscore=0 mlxlogscore=695 adultscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.0.1-1911140001 definitions=main-1911150155 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:171679 Archived-At: > > I think the doc about equality of markers should be improved. >=20 > I don't understand what are the practical problems caused by the > current text in the manual. It seems the information you were after > is present, so it isn't clear what exactly is the problem here. >=20 > It seems that the only problem you have is the place where the details > of 'equal' for markers are described? I think the bug report is pretty clear, detailed, and specific. But to provide a quick summary response: 1. Yes, "Creating Markers" is not the best place for specifying equality tests between markers. 2. There should be an example for `equal' that shows inequality when the positions are the same but the buffers differ. 3. In the section about markers, there should be a mention of how to compare markers with regard only to their positions, i.e., use `=3D'. This, from the bug report, says what I think is needed, as a minimum: 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). Please consider putting all of the info in the section about markers, mentioning the different equality tests: `eq', `equal', and `=3D'.