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#38051: 26.3; (elisp) `Insertion' use of verb "point" Date: Sun, 3 Nov 2019 13:26:08 -0800 (PST) Message-ID: <10c2ca80-b3d5-4efb-a2b1-5ded0cc8a14d@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="200352"; mail-complaints-to="usenet@blaine.gmane.org" To: 38051@debbugs.gnu.org Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Sun Nov 03 22:27:25 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 1iRNPB-000q25-En for geb-bug-gnu-emacs@m.gmane.org; Sun, 03 Nov 2019 22:27:25 +0100 Original-Received: from localhost ([::1]:56470 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1iRNPA-0004VP-8c for geb-bug-gnu-emacs@m.gmane.org; Sun, 03 Nov 2019 16:27:24 -0500 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:55287) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1iRNOv-0004Sk-0y for bug-gnu-emacs@gnu.org; Sun, 03 Nov 2019 16:27:10 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1iRNOt-0004mk-1r for bug-gnu-emacs@gnu.org; Sun, 03 Nov 2019 16:27:08 -0500 Original-Received: from debbugs.gnu.org ([209.51.188.43]:54772) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1iRNOr-0004mQ-G9 for bug-gnu-emacs@gnu.org; Sun, 03 Nov 2019 16:27:06 -0500 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1iRNOr-0005MF-2Y for bug-gnu-emacs@gnu.org; Sun, 03 Nov 2019 16:27:05 -0500 X-Loop: help-debbugs@gnu.org Resent-From: Drew Adams Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Sun, 03 Nov 2019 21:27:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: report 38051 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.157281638020459 (code B ref -1); Sun, 03 Nov 2019 21:27:02 +0000 Original-Received: (at submit) by debbugs.gnu.org; 3 Nov 2019 21:26:20 +0000 Original-Received: from localhost ([127.0.0.1]:35300 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1iRNO7-0005Ju-Vp for submit@debbugs.gnu.org; Sun, 03 Nov 2019 16:26:20 -0500 Original-Received: from lists.gnu.org ([209.51.188.17]:51251) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1iRNO3-0005Jb-TH for submit@debbugs.gnu.org; Sun, 03 Nov 2019 16:26:18 -0500 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:55097) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1iRNO2-0003mE-IH for bug-gnu-emacs@gnu.org; Sun, 03 Nov 2019 16:26:15 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1iRNO0-0004SW-UY for bug-gnu-emacs@gnu.org; Sun, 03 Nov 2019 16:26:14 -0500 Original-Received: from userp2120.oracle.com ([156.151.31.85]:53680) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_256_CBC_SHA1:32) (Exim 4.71) (envelope-from ) id 1iRNO0-0004SB-Ls for bug-gnu-emacs@gnu.org; Sun, 03 Nov 2019 16:26:12 -0500 Original-Received: from pps.filterd (userp2120.oracle.com [127.0.0.1]) by userp2120.oracle.com (8.16.0.27/8.16.0.27) with SMTP id xA3L9RR6019364 for ; Sun, 3 Nov 2019 21:26:11 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=aTlZl3zZrDE8hNgCNyu7xzUwKy09QibN61JaxO9lLk4=; b=hgTn+j23tKi+KduAyt202RpFJNPMyiRwrHNpKwFf/xe+EEPEK/rJtC1GxQ8FffX2Yun8 LQ2pcXXEc48Y6bvHWqTqlBiR7PDx1yJKcMKJrknCY0KhPJHzC8qUZtPwzHBHjTReIx75 rHQmaZuE+3E/d934sDcawXI9s7mvT3s6knm1DiwatLvZgFyCkzKRt2BEciK6ooHpPACW I8p1Na1WdCSzpCXBOUoNCgIAf68RG17Qw1LNzuzZePK6LSip6FRnRpjmZ1jaxLkw8DWv IGyIBPQSHEGTCDmo/M39Op3NSqdJryIRqmMI3nWjegR2K5PTcLynnMPq25uOeSU3hhY7 ZQ== Original-Received: from aserp3020.oracle.com (aserp3020.oracle.com [141.146.126.70]) by userp2120.oracle.com with ESMTP id 2w12equx9y-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK) for ; Sun, 03 Nov 2019 21:26:11 +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 xA3LDAEI186147 for ; Sun, 3 Nov 2019 21:26:10 GMT Original-Received: from userv0121.oracle.com (userv0121.oracle.com [156.151.31.72]) by aserp3020.oracle.com with ESMTP id 2w1ka89xwp-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK) for ; Sun, 03 Nov 2019 21:26:10 +0000 Original-Received: from abhmp0006.oracle.com (abhmp0006.oracle.com [141.146.116.12]) by userv0121.oracle.com (8.14.4/8.13.8) with ESMTP id xA3LQ90S016574 for ; Sun, 3 Nov 2019 21:26:09 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=9430 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=999 adultscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.0.1-1908290000 definitions=main-1911030223 X-Proofpoint-Virus-Version: vendor=nai engine=6000 definitions=9430 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=1015 lowpriorityscore=0 mlxscore=0 impostorscore=0 mlxlogscore=999 adultscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.0.1-1908290000 definitions=main-1911030223 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:170902 Archived-At: In a few places this node uses the verb "to point" to refer to a marker's position, as in the marker points to position N. This is unfortunate, as it makes the text confusing - especially so because the text in the node refers often to "point" meaning, well, point, the position of the cursor. Too many occurrences of "point", and in some cases with different possible meanings (some of which are wrong). It would be better to just talk about the position of the marker, or the position the marker has, than to talk about the position the marker points to. Examples: 1. When a marker points at the place of insertion... 2. Certain special functions such as `insert-before-markers' relocate all such markers to point after the inserted text, regardless of the markers' insertion type. 3. ...it relocates markers initially pointing at the insertion point, to point after the inserted text. #1 is not confusing or ambiguous. #2 and #3 can confuse you into thinking that "point after the inserted text" is maybe talking about point (the cursor position) being (just) after the inserted text, as if the text had another comma: "relocate all such markers to point, after the inserted text,..." Yes, lack of that comma does make the meaning clear, unless you read the text carefully you can be confused or misled. If the text instead speaks of the position of a marker, or speaks of where a marker "is", instead of speaking of where a marker "points", the problem disappears. E.g.: 1. When a marker is at the place of insertion... 2. Certain special functions such as `insert-before-markers' relocate all such markers to be after the inserted text, regardless of the markers' insertion type. 3. ...it relocates markers that are initially at the insertion point, to be after the inserted text. (This node also talks about "code point", which is a third meaning for "point". But that's unavoidable, and the text is not confusing.) 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''