From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!.POSTED!not-for-mail From: Jean-Christophe Helary Newsgroups: gmane.emacs.devel Subject: Re: "Point" vs. "cursor" in documentation Date: Wed, 4 Jul 2018 15:21:42 +0900 Message-ID: References: <037e45ba-ae4d-7aa7-bfa2-dd6a27aaff26@disroot.org> <0a994a51-b80b-9d78-9e9e-0d379ffa5733@disroot.org> NNTP-Posting-Host: blaine.gmane.org Mime-Version: 1.0 (Mac OS X Mail 11.4 \(3445.8.2\)) Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable X-Trace: blaine.gmane.org 1530685294 12008 195.159.176.226 (4 Jul 2018 06:21:34 GMT) X-Complaints-To: usenet@blaine.gmane.org NNTP-Posting-Date: Wed, 4 Jul 2018 06:21:34 +0000 (UTC) Cc: emacs-devel@gnu.org To: Stefan Monnier Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Wed Jul 04 08:21:30 2018 Return-path: Envelope-to: ged-emacs-devel@m.gmane.org Original-Received: from lists.gnu.org ([208.118.235.17]) by blaine.gmane.org with esmtp (Exim 4.84_2) (envelope-from ) id 1fabAP-00030u-Om for ged-emacs-devel@m.gmane.org; Wed, 04 Jul 2018 08:21:29 +0200 Original-Received: from localhost ([::1]:44272 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1fabCX-0007xo-08 for ged-emacs-devel@m.gmane.org; Wed, 04 Jul 2018 02:23:41 -0400 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:50779) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1fabBs-0007xW-DJ for emacs-devel@gnu.org; Wed, 04 Jul 2018 02:23:01 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1fabBp-0008Ex-6V for emacs-devel@gnu.org; Wed, 04 Jul 2018 02:23:00 -0400 Original-Received: from mail-pg0-x233.google.com ([2607:f8b0:400e:c05::233]:37808) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1fabBo-0008Ef-Vk for emacs-devel@gnu.org; Wed, 04 Jul 2018 02:22:57 -0400 Original-Received: by mail-pg0-x233.google.com with SMTP id n15-v6so2047425pgv.4 for ; Tue, 03 Jul 2018 23:22:56 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20161025; h=mime-version:subject:from:in-reply-to:date:cc :content-transfer-encoding:message-id:references:to; bh=o0I/J7TlRv101ZKvud2MPLsEVRtBEHwE8gErEOaYkTY=; b=PF0OuDq+MLjZVs0iXfDYozkNPwVrPKoJgarwElIgJlJ8IQI3n0x7LhfOgGCGLYW4S3 6M7ICUnopgApipxTty7w7P+oFnyZLI/QNGu/BfxTWByQ+Nj8tliqfKrwG4GrvvnEy6h/ KRXYO9b5q0AEOXAL1IHPMNUet2rOjPBRSGhIAGXTaCk8zLOn+hLw5saYH4xsgF1/bsEY 9z+gCslHbs/iCYP8UeOL9WNLsYcdC3oMue+b7Q0JJMMYaKRG3bU4Fwg+0WZwwi8JJPXI qlm1UIyZLfYqIbr/qbLSBAmiDT8asUeDNtzlvbJn4eDQLkSKGb4eA9fyRuYxEoSTNfF2 R5Jg== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:mime-version:subject:from:in-reply-to:date:cc :content-transfer-encoding:message-id:references:to; bh=o0I/J7TlRv101ZKvud2MPLsEVRtBEHwE8gErEOaYkTY=; b=HtrhESscnBVGxjVJ8TwFuouxsZCfhsHorq5JerStS6isZmni1WmxdM3sdSTA3TFXfN JBYIMjLrpeULGZSOqWbWguZnKRswpdYNcicC5Ayd5sijh6Zann7eyATYkQGALtOSNzko 3oD9m/igH4S9ZAGS6EjhjPUkgS4KkS9J1rdeSJnFOAwnoX8n8ZMY/eJUq5MYvhUUqWIf HvXBXZg7LoqofN1L1gVp/RdfLhrc1nprQEy3ZsPR8McpYPu/x0aJNGV0M1UmaZt18lv8 /M794z6yNz9n2joJ00Ntqa5QtDFTCIjJ8MeZdHvTtfDqdCd0EGQ9I9LtGbmy5jHXW7ai Mbgw== X-Gm-Message-State: APt69E3t9xHlucir8BMSDWmCgWhnwlDgrp+GEibqZDW8AUkLpGKgS+m/ y1c1RkxuKYIE162UGXiq5Z8= X-Google-Smtp-Source: AAOMgpc3v2eqCN1e54tQnNi07Mbs2lAlwnK59xoubApS766fyAREEHHDMPJGjlsmf259Ju5oUiVRJg== X-Received: by 2002:a62:1358:: with SMTP id b85-v6mr821794pfj.238.1530685375726; Tue, 03 Jul 2018 23:22:55 -0700 (PDT) Original-Received: from [10.60.229.25] (106171079183.wi-fi.kddi.com. [106.171.79.183]) by smtp.gmail.com with ESMTPSA id s185-v6sm7331007pfb.116.2018.07.03.23.22.53 (version=TLS1_2 cipher=ECDHE-RSA-AES128-GCM-SHA256 bits=128/128); Tue, 03 Jul 2018 23:22:54 -0700 (PDT) In-Reply-To: X-Mailer: Apple Mail (2.3445.8.2) X-detected-operating-system: by eggs.gnu.org: Genre and OS details not recognized. X-Received-From: 2607:f8b0:400e:c05::233 X-BeenThere: emacs-devel@gnu.org X-Mailman-Version: 2.1.21 Precedence: list List-Id: "Emacs development discussions." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Original-Sender: "Emacs-devel" Xref: news.gmane.org gmane.emacs.devel:226927 Archived-At: > On Jul 4, 2018, at 11:39, Stefan Monnier = wrote: >=20 >> When do we use point over cursor, and vice versa, in documentation? >=20 > "Point" is concerned about where operations will happen, whereas > "cursor" is concerned about where the thingy will be drawn on screen. > The cursor only moves when the display gets refreshed (i.e. once per > command, more or less), whereas point can be modified by lots of > intermediate operations, so it can change thousands of times within > a single command. Which is the reason why "save-excursion" is used: Introduction, 3.10 "In Emacs, a function frequently moves point as part of its internal = workings even though a user would not expect this. For example, = count-lines-region moves point. To prevent the user from being bothered = by jumps that are both unexpected and (from the user=E2=80=99s point of = view) unnecessary, save-excursion is often used to keep point in the = location expected by the user. The use of save-excursion is good = housekeeping." Jean-Christophe Helary ----------------------------------------------- http://mac4translators.blogspot.com @brandelune