From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Drew Adams Newsgroups: gmane.emacs.devel Subject: RE: [Emacs-diffs] emacs-25 6bd9d69: Fix documentation of 'global-disable-point-adjustment' Date: Mon, 22 Feb 2016 23:10:39 -0800 (PST) Message-ID: <15a3b6c8-29ac-4b80-918a-f921e7b3a0d6@default> References: <<20160222173059.20603.67344@vcs.savannah.gnu.org> > <<83k2lwk0er.fsf@gnu.org> > <<83io1gjwlp.fsf@gnu.org> > <<83fuwkjecd.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 1456211480 26105 80.91.229.3 (23 Feb 2016 07:11:20 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Tue, 23 Feb 2016 07:11:20 +0000 (UTC) Cc: emacs-devel@gnu.org To: Eli Zaretskii , Stefan Monnier Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Tue Feb 23 08:11:08 2016 Return-path: Envelope-to: ged-emacs-devel@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 1aY77i-0005zW-U2 for ged-emacs-devel@m.gmane.org; Tue, 23 Feb 2016 08:11:07 +0100 Original-Received: from localhost ([::1]:54486 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1aY77h-00066c-Uw for ged-emacs-devel@m.gmane.org; Tue, 23 Feb 2016 02:11:05 -0500 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:48495) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1aY77V-00066U-18 for emacs-devel@gnu.org; Tue, 23 Feb 2016 02:10:53 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1aY77U-0001E9-3F for emacs-devel@gnu.org; Tue, 23 Feb 2016 02:10:52 -0500 Original-Received: from userp1040.oracle.com ([156.151.31.81]:23390) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1aY77N-0001Dq-Ox; Tue, 23 Feb 2016 02:10:45 -0500 Original-Received: from userv0021.oracle.com (userv0021.oracle.com [156.151.31.71]) by userp1040.oracle.com (Sentrion-MTA-4.3.2/Sentrion-MTA-4.3.2) with ESMTP id u1N7AghS011905 (version=TLSv1 cipher=DHE-RSA-AES256-SHA bits=256 verify=OK); Tue, 23 Feb 2016 07:10:43 GMT Original-Received: from aserv0121.oracle.com (aserv0121.oracle.com [141.146.126.235]) by userv0021.oracle.com (8.13.8/8.13.8) with ESMTP id u1N7Afrk026358 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=FAIL); Tue, 23 Feb 2016 07:10:42 GMT Original-Received: from abhmp0010.oracle.com (abhmp0010.oracle.com [141.146.116.16]) by aserv0121.oracle.com (8.13.8/8.13.8) with ESMTP id u1N7Aex2024781; Tue, 23 Feb 2016 07:10:41 GMT In-Reply-To: <<83fuwkjecd.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: userv0021.oracle.com [156.151.31.71] X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.4.x-2.6.x [generic] X-Received-From: 156.151.31.81 X-BeenThere: emacs-devel@gnu.org X-Mailman-Version: 2.1.14 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-bounces+ged-emacs-devel=m.gmane.org@gnu.org Xref: news.gmane.org gmane.emacs.devel:200531 Archived-At: > > >> Why did you replace "sets" with "binds"? > > > Because that's how I tend to think about the act of giving a value to > > > a variable in Emacs Lisp. > > > > OK. To me, the fact that disable-point-adjustment needs to be setq'd b= y > > the command rather than let-bound is an important point (I'd expect thi= s > > to surprise many coders since the usual way for a command to affect the > > behavior of Emacs "for this command only" is to let-bind a variable), s= o > > I find the new wording to encourage confusion rather than trying to > > avoid it. >=20 > If this is confusing, I will changing it back. What do others think? I agree with Stefan here. Generally use "set" for assignment=20 (regardless of whether the symbol has already been bound in any way). Use "bind" for a `let' binding. It's true that we also speak of a symbol being unbound or bound depending on whether its value cell is void. But most of the uses of "bound" and "bind" for symbols in Emacs have to do with `let' bindings. However, if it is important in this particular context to make clear that "disable-point-adjustment needs to be setq'd by the command rather than let-bound" then I'd say that, to remove any ambiguity.