From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Michael Witten Newsgroups: gmane.emacs.bugs Subject: bug#11862: Splitting and simplifying [PATCH 8/9] Date: Fri, 06 Jul 2012 20:06:38 -0000 Message-ID: <31927313f03b410aaa9830427ff3a0c1-mfwitten@gmail.com> References: <22f1c29cd7e44a3e91ca67e534dc03a4-mfwitten@gmail.com> <3c1c3c1cfe3840e19551bfd0424eb99d-mfwitten@gmail.com> <0c2cb6909a904ffeb3010bf4ca2e40b2-mfwitten@gmail.com> <85pq88c0nj.fsf@iznogoud.viz> NNTP-Posting-Host: plane.gmane.org X-Trace: dough.gmane.org 1341607395 28962 80.91.229.3 (6 Jul 2012 20:43:15 GMT) X-Complaints-To: usenet@dough.gmane.org NNTP-Posting-Date: Fri, 6 Jul 2012 20:43:15 +0000 (UTC) Cc: 11862@debbugs.gnu.org, Wolfgang Jenkner , Richard Stallman To: Drew Adams Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Fri Jul 06 22:43:13 2012 Return-path: Envelope-to: geb-bug-gnu-emacs@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 1SnFMs-0002WC-Bm for geb-bug-gnu-emacs@m.gmane.org; Fri, 06 Jul 2012 22:43:10 +0200 Original-Received: from localhost ([::1]:48357 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1SnFMr-0004b0-AM for geb-bug-gnu-emacs@m.gmane.org; Fri, 06 Jul 2012 16:43:09 -0400 Original-Received: from eggs.gnu.org ([208.118.235.92]:44813) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1SnFMn-0004ac-El for bug-gnu-emacs@gnu.org; Fri, 06 Jul 2012 16:43:06 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1SnFMl-0001n7-I0 for bug-gnu-emacs@gnu.org; Fri, 06 Jul 2012 16:43:05 -0400 Original-Received: from debbugs.gnu.org ([140.186.70.43]:43704) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1SnFMl-0001n0-Bv for bug-gnu-emacs@gnu.org; Fri, 06 Jul 2012 16:43:03 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.72) (envelope-from ) id 1SnFRa-0007Ve-ND for bug-gnu-emacs@gnu.org; Fri, 06 Jul 2012 16:48:02 -0400 X-Loop: help-debbugs@gnu.org Resent-From: Michael Witten Original-Sender: debbugs-submit-bounces@debbugs.gnu.org Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Fri, 06 Jul 2012 20:48:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 11862 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: patch Original-Received: via spool by 11862-submit@debbugs.gnu.org id=B11862.134160764428811 (code B ref 11862); Fri, 06 Jul 2012 20:48:02 +0000 Original-Received: (at 11862) by debbugs.gnu.org; 6 Jul 2012 20:47:24 +0000 Original-Received: from localhost ([127.0.0.1]:53246 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1SnFQx-0007Ud-Li for submit@debbugs.gnu.org; Fri, 06 Jul 2012 16:47:24 -0400 Original-Received: from mail-pb0-f44.google.com ([209.85.160.44]:55358) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1SnFQt-0007UV-Ub for 11862@debbugs.gnu.org; Fri, 06 Jul 2012 16:47:21 -0400 Original-Received: by pbcwy7 with SMTP id wy7so14032056pbc.3 for <11862@debbugs.gnu.org>; Fri, 06 Jul 2012 13:42:18 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20120113; h=subject:date:from:to:cc:message-id:in-reply-to:references; bh=VnAliMyq1QuhP+oSAsslswj4Kqqr2tZZOPugLSUGSwc=; b=HXrYwn4cJkBPMlt4bvD8z7S8ewcFDXKv3b8fM52Ni/KZkByap9oo0Vb20dG+NqXeZA vgbEY1bRQkEfh6jaWqMf6kFL8O3J6E7c+vVW/yYapMl+/5wVHIAuik/n10mA4q99yAo+ RmM/aPv8Fz9g8B2ZGAbXNn+9OijyIcI/gjpy1GZrKKqnX1+RmxZQeQu+p9UsaibD1Typ p9k2TZTlWr226B5q17UizKtgX9mW/byrJbm2PQ/2jOAJBUmrNVUfAVFFm0HKcdXXNUJh QjPKGwumPM8+rbKA+4C/u7Mb0qmPZJ1FmGYZcWV36R8qYZ5C9nr6bZmA56aXtWLiR5Ik +6Jg== Original-Received: by 10.68.223.129 with SMTP id qu1mr39325807pbc.165.1341607338005; Fri, 06 Jul 2012 13:42:18 -0700 (PDT) Original-Received: from gmail.com ([188.127.231.134]) by mx.google.com with ESMTPS id ng8sm22499727pbc.13.2012.07.06.13.42.12 (version=TLSv1/SSLv3 cipher=OTHER); Fri, 06 Jul 2012 13:42:17 -0700 (PDT) In-Reply-To: X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.13 Precedence: list X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6 (newer, 2) X-Received-From: 140.186.70.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-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Xref: news.gmane.org gmane.emacs.bugs:61666 Archived-At: On Fri, 6 Jul 2012 09:45:11 -0700, Drew Adams wrote: >>> binding is frequently referred to as setting, >> >> This is a bit misleading > > I agree. Binding and setting (assigning) are not the same. > > FWIW, here is Common Lisp on "assigning": > http://www.cs.cmu.edu/Groups/AI/html/cltl/clm/node79.html > > and on "binding": > http://www.cs.cmu.edu/Groups/AI/html/cltl/clm/node83.html#SECTION001150000000000000000 > > And there is this, from the book "Successful Lisp": > http://psg.com/~dlamkins/sl/chapter03-06.html Yes, that was wrongheaded of me. I think the best thing to do would be to stick with trivial modifications, so I've removed the meddling with node `Variables', and then split the remaining organizational changes into 2 patches: [8a/9] Introduce the term `value' early on [8b/9] Reduce and reorganize node `A sample Variable Description' Here is the overall diff (please reply to the relevant patch email): diff --git a/doc/lispref/intro.texi b/doc/lispref/intro.texi index 5ca4d37..b62bceb 100644 --- a/doc/lispref/intro.texi +++ b/doc/lispref/intro.texi @@ -147,10 +147,11 @@ manual. You may want to skip this section and refer back to it later. Throughout this manual, the phrases ``the Lisp reader'' and ``the Lisp printer'' refer to those routines in Lisp that convert textual representations of Lisp objects into actual Lisp objects, and vice -versa. @xref{Printed Representation}, for more details. You, the -person reading this manual, are thought of as ``the programmer'' and are -addressed as ``you''. ``The user'' is the person who uses Lisp -programs, including those you write. +versa. @xref{Printed Representation}, for more details. A Lisp object +is commonly referred to as a @dfn{value}. You, the person reading this +manual, are thought of as ``the programmer'' and are addressed as ``you''. +``The user'' is the person who uses Lisp programs, including those you +write. @cindex typographic conventions Examples of Lisp code are formatted like this: @code{(list 1 2 3)}. @@ -446,14 +447,9 @@ from @var{body}, which includes all remaining elements of the form. @cindex variable descriptions @cindex option descriptions - A @dfn{variable} is a name that can hold a value. Although nearly -all variables can be set by the user, certain variables exist -specifically so that users can change them; these are called @dfn{user -options}. Ordinary variables and user options are described using a -format like that for functions except that there are no arguments. - - Here is a description of the imaginary @code{electric-future-map} -variable.@refill +Variables are described using a format like that for functions, except +that there are no arguments. Here is a description of the imaginary +@code{electric-future-map} variable.@refill @defvar electric-future-map The value of this variable is a full keymap used by Electric Command @@ -461,8 +457,10 @@ Future mode. The functions in this map allow you to edit commands you have not yet thought about executing. @end defvar - User option descriptions have the same format, but `Variable' is -replaced by `User Option'. +Although nearly all variables can be set by the user, certain variables +exist specifically so that users can change them; these are called +@dfn{user options}. User option descriptions have the same format, +but `Variable' is replaced by `User Option'. @node Version Info @section Version Information diff --git a/doc/lispref/functions.texi b/doc/lispref/functions.texi index ab2789b..b0eea05 100644 --- a/doc/lispref/functions.texi +++ b/doc/lispref/functions.texi @@ -37,7 +37,7 @@ define them. @cindex argument In a general sense, a function is a rule for carrying out a computation given input values called @dfn{arguments}. The result of -the computation is called the @dfn{value} or @dfn{return value} of the +the computation is called the @dfn{return value} (or the ``value'') of the function. The computation can also have side effects, such as lasting changes in the values of variables or the contents of data structures.