From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Stefan Monnier Newsgroups: gmane.emacs.devel Subject: Re: [Emacs-diffs] emacs-25 6bd9d69: Fix documentation of 'global-disable-point-adjustment' Date: Mon, 22 Feb 2016 16:13:36 -0500 Message-ID: References: <20160222173059.20603.67344@vcs.savannah.gnu.org> <83k2lwk0er.fsf@gnu.org> <83io1gjwlp.fsf@gnu.org> NNTP-Posting-Host: plane.gmane.org Mime-Version: 1.0 Content-Type: text/plain X-Trace: ger.gmane.org 1456175650 6055 80.91.229.3 (22 Feb 2016 21:14:10 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Mon, 22 Feb 2016 21:14:10 +0000 (UTC) Cc: emacs-devel@gnu.org To: Eli Zaretskii Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Mon Feb 22 22:14:01 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 1aXxnr-000748-Rh for ged-emacs-devel@m.gmane.org; Mon, 22 Feb 2016 22:13:59 +0100 Original-Received: from localhost ([::1]:52056 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1aXxnr-0005pp-4o for ged-emacs-devel@m.gmane.org; Mon, 22 Feb 2016 16:13:59 -0500 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:60503) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1aXxne-0005pi-BO for emacs-devel@gnu.org; Mon, 22 Feb 2016 16:13:47 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1aXxnb-0006Ei-5C for emacs-devel@gnu.org; Mon, 22 Feb 2016 16:13:46 -0500 Original-Received: from pruche.dit.umontreal.ca ([132.204.246.22]:46558) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1aXxna-0006Ea-WA; Mon, 22 Feb 2016 16:13:43 -0500 Original-Received: from fmsmemgm.homelinux.net (lechon.iro.umontreal.ca [132.204.27.242]) by pruche.DIT.UMontreal.CA (8.14.1/8.14.1) with ESMTP id u1MLDaqr007699; Mon, 22 Feb 2016 16:13:36 -0500 Original-Received: by fmsmemgm.homelinux.net (Postfix, from userid 20848) id C298BAE48B; Mon, 22 Feb 2016 16:13:36 -0500 (EST) In-Reply-To: <83io1gjwlp.fsf@gnu.org> (Eli Zaretskii's message of "Mon, 22 Feb 2016 22:53:06 +0200") User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/25.1.50 (gnu/linux) X-NAI-Spam-Flag: NO X-NAI-Spam-Threshold: 5 X-NAI-Spam-Score: 0 X-NAI-Spam-Rules: 1 Rules triggered RV5589=0 X-NAI-Spam-Version: 2.3.0.9418 : core <5589> : inlines <4371> : streams <1591849> : uri <2148821> X-detected-operating-system: by eggs.gnu.org: Genre and OS details not recognized. X-Received-From: 132.204.246.22 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:200501 Archived-At: >> To me the difference between "sets" and "binds" is that the former >> clearly means "setq" while the other can either mean "change it from >> unbound to bound" or "let-binds". >> So, I find "binds" to be less precise than "sets", hence my question: >> 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 by the command rather than let-bound is an important point (I'd expect this 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), so I find the new wording to encourage confusion rather than trying to avoid it. But clearly you have a different opinion, and I honestly can't claim to know better, especially when it comes to writing docs, so I'll shut up now, Stefan