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: [PATCH 8/9 v2] doc/lispref/intro.texi: More precise language for what a variable is Date: Thu, 05 Jul 2012 22:55:46 -0000 Message-ID: <3c1c3c1cfe3840e19551bfd0424eb99d-mfwitten@gmail.com> References: <22f1c29cd7e44a3e91ca67e534dc03a4-mfwitten@gmail.com> NNTP-Posting-Host: plane.gmane.org X-Trace: dough.gmane.org 1341529877 7340 80.91.229.3 (5 Jul 2012 23:11:17 GMT) X-Complaints-To: usenet@dough.gmane.org NNTP-Posting-Date: Thu, 5 Jul 2012 23:11:17 +0000 (UTC) Cc: 11862@debbugs.gnu.org To: Richard Stallman Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Fri Jul 06 01:11:15 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 1SmvCb-0004W4-JY for geb-bug-gnu-emacs@m.gmane.org; Fri, 06 Jul 2012 01:11:13 +0200 Original-Received: from localhost ([::1]:52544 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1SmvCa-0004FR-8f for geb-bug-gnu-emacs@m.gmane.org; Thu, 05 Jul 2012 19:11:12 -0400 Original-Received: from eggs.gnu.org ([208.118.235.92]:42926) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1SmvCX-0004F4-BG for bug-gnu-emacs@gnu.org; Thu, 05 Jul 2012 19:11:10 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1SmvCV-0002lB-M6 for bug-gnu-emacs@gnu.org; Thu, 05 Jul 2012 19:11:08 -0400 Original-Received: from debbugs.gnu.org ([140.186.70.43]:41588) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1SmvCV-0002l3-Fw for bug-gnu-emacs@gnu.org; Thu, 05 Jul 2012 19:11:07 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.72) (envelope-from ) id 1SmvHF-0000KW-JI for bug-gnu-emacs@gnu.org; Thu, 05 Jul 2012 19:16:01 -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: Thu, 05 Jul 2012 23:16:01 +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.13415301051208 (code B ref 11862); Thu, 05 Jul 2012 23:16:01 +0000 Original-Received: (at 11862) by debbugs.gnu.org; 5 Jul 2012 23:15:05 +0000 Original-Received: from localhost ([127.0.0.1]:51134 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1SmvGL-0000JQ-5o for submit@debbugs.gnu.org; Thu, 05 Jul 2012 19:15:05 -0400 Original-Received: from mail-lb0-f172.google.com ([209.85.217.172]:64518) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1SmvGI-0000J1-SA for 11862@debbugs.gnu.org; Thu, 05 Jul 2012 19:15:03 -0400 Original-Received: by lbbgo11 with SMTP id go11so12180885lbb.3 for <11862@debbugs.gnu.org>; Thu, 05 Jul 2012 16:10:06 -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=1vjvCG8yK50DcCf98MBdpqojcGwSCo+BQniUiCLg+M4=; b=FeEZSKMFJO0Iy2BisuatIfbLk10rhJESowdMyWnnM6F38Vupjc1BXEnCQodJR2vQrh lcuE9gqvzRY2W3BCwDEZgzTPaPpF8A1h48j+jXzu2tToYGwvxeQ9CnYVSHzB0XTlpofL jg13fAHRONsbAdzEUe5+orBWrH2ML8+lGF13W1N3u4ANZ/nB5EmE96QdUP6UFLgOXm2F GQN1QLWDM9ecaADm5jXjiPVrJvuv3egkBhcivPwB5rdStbGLXY5CaShkwQt+BMG8EYXw 6pNUU/tuojDP7b9CPiXlvxkRoNBCVL3ra5o4yzOlKuqRMY5G6qKgGHpoTb/8yQQHLdrc L/gA== Original-Received: by 10.112.46.101 with SMTP id u5mr12673620lbm.21.1341529806282; Thu, 05 Jul 2012 16:10:06 -0700 (PDT) Original-Received: from gmail.com (exit-01d.noisetor.net. [173.254.216.69]) by mx.google.com with ESMTPS id h6sm14498120lbl.13.2012.07.05.16.10.02 (version=TLSv1/SSLv3 cipher=OTHER); Thu, 05 Jul 2012 16:10:04 -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:61630 Archived-At: On Thu, 05 Jul 2012 17:50:43 -0400, Richard Stallman wrote: > + A @dfn{variable} is a name that can be bound to an object; binding > +is frequently referred to as `setting', and the object to which > +a variable is `set' is often called a `value' that the variable > +`holds'. > > This change might be ok, but please use @dfn around the terms that are > introduced, rather than single quotes. @dfn exists precisely for > this. The following is an updated patch; save this email and apply it with: git am -c "$path_to_saved_email" --8<-----------8<-----------8<-----------8<-----------8<-----------8<--------- The terms `set' and `bind', `object' and `value', and `hold' are used somewhat freely; this commit introduces more pedantic language (while still mentioning the others). --- doc/lispref/intro.texi | 13 ++++++++----- 1 file changed, 8 insertions(+), 5 deletions(-) diff --git a/doc/lispref/intro.texi b/doc/lispref/intro.texi index 5ca4d37..da4cd80 100644 --- a/doc/lispref/intro.texi +++ b/doc/lispref/intro.texi @@ -446,11 +446,14 @@ 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. + A @dfn{variable} is a name that can be bound to an object; binding +is frequently referred to as @dfn{setting}, and the object to which +a variable is set is often called a @dfn{value} that the variable +@dfn{holds}. 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 -- 1.7.11.1.29.gf71be5c