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] doc/lispref/intro.texi: More precise language for Date: Wed, 04 Jul 2012 20:15:59 -0000 Message-ID: <22f1c29cd7e44a3e91ca67e534dc03a4-mfwitten@gmail.com> References: NNTP-Posting-Host: plane.gmane.org X-Trace: dough.gmane.org 1341434190 8330 80.91.229.3 (4 Jul 2012 20:36:30 GMT) X-Complaints-To: usenet@dough.gmane.org NNTP-Posting-Date: Wed, 4 Jul 2012 20:36:30 +0000 (UTC) To: 11862@debbugs.gnu.org Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Wed Jul 04 22:36:29 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 1SmWJI-0002wi-1Z for geb-bug-gnu-emacs@m.gmane.org; Wed, 04 Jul 2012 22:36:28 +0200 Original-Received: from localhost ([::1]:38501 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1SmWJG-0007no-VG for geb-bug-gnu-emacs@m.gmane.org; Wed, 04 Jul 2012 16:36:26 -0400 Original-Received: from eggs.gnu.org ([208.118.235.92]:35829) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1SmWJ7-0007Og-PZ for bug-gnu-emacs@gnu.org; Wed, 04 Jul 2012 16:36:19 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1SmWJ5-0003Ux-3r for bug-gnu-emacs@gnu.org; Wed, 04 Jul 2012 16:36:17 -0400 Original-Received: from debbugs.gnu.org ([140.186.70.43]:39047) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1SmWJ4-0003Uq-U5 for bug-gnu-emacs@gnu.org; Wed, 04 Jul 2012 16:36:15 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.72) (envelope-from ) id 1SmWNj-0006Ws-3c for bug-gnu-emacs@gnu.org; Wed, 04 Jul 2012 16:41:03 -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: Wed, 04 Jul 2012 20:41:03 +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 X-Debbugs-Original-To: bug-gnu-emacs@gnu.org Original-Received: via spool by submit@debbugs.gnu.org id=B.134143441825008 (code B ref -1); Wed, 04 Jul 2012 20:41:03 +0000 Original-Received: (at submit) by debbugs.gnu.org; 4 Jul 2012 20:40:18 +0000 Original-Received: from localhost ([127.0.0.1]:48583 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1SmWMz-0006VE-Cq for submit@debbugs.gnu.org; Wed, 04 Jul 2012 16:40:17 -0400 Original-Received: from eggs.gnu.org ([208.118.235.92]:56786) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1SmWMr-0006UH-K6 for submit@debbugs.gnu.org; Wed, 04 Jul 2012 16:40:12 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1SmWI9-00032y-Er for submit@debbugs.gnu.org; Wed, 04 Jul 2012 16:35:20 -0400 Original-Received: from lists.gnu.org ([208.118.235.17]:47202) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1SmWI9-0002x1-8d for submit@debbugs.gnu.org; Wed, 04 Jul 2012 16:35:17 -0400 Original-Received: from eggs.gnu.org ([208.118.235.92]:60782) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1SmW3l-0005l4-T8 for bug-gnu-emacs@gnu.org; Wed, 04 Jul 2012 16:20:27 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1SmW3j-0006zx-Tu for bug-gnu-emacs@gnu.org; Wed, 04 Jul 2012 16:20:25 -0400 Original-Received: from mail-lb0-f169.google.com ([209.85.217.169]:47536) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1SmW3j-0006Fy-K2 for bug-gnu-emacs@gnu.org; Wed, 04 Jul 2012 16:20:23 -0400 Original-Received: by mail-lb0-f169.google.com with SMTP id n8so4689818lbj.0 for ; Wed, 04 Jul 2012 13:20:22 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20120113; h=subject:date:from:to:message-id:in-reply-to:references; bh=YJAtreXKzFUuM/AAanryI3QaARqxG3CtqkfceMk5hQc=; b=MvcNf/R0OqQ0dyKcmyJW/F2qxUrsviCXi6qO7q5AUiUI6+SQBUu8/ZycKXA/WuqZNi xMI97tgwl2ZYs14Z8W1ptciKwnxGep9BVQW8G0sQD4xVFpX+NxdpWfdT/LfOQazWoj38 OX7n38+l5MS+7yIk+7BUAns1HbUx3y3oUWs+e27QHN8+7kO5x7FaVoRLqRxBLAkGs/B1 Dc8jASSF5YLaEckNhv5EnF7gCV7rK+7pCCaTKAUajDVHOthZ1gdFWTBaK0xLdEUmE9j1 BApvg2LpmvYsV3shoBF29umK1xklg9cmrbYWpMcAe3w2R3y7tyRwNBwykIkTg3b75SkS wkzw== Original-Received: by 10.112.83.229 with SMTP id t5mr10724502lby.8.1341433222642; Wed, 04 Jul 2012 13:20:22 -0700 (PDT) Original-Received: from gmail.com (tor6.anonymizer.ccc.de. [80.237.226.76]) by mx.google.com with ESMTPS id mo3sm33951827lab.2.2012.07.04.13.20.20 (version=TLSv1/SSLv3 cipher=OTHER); Wed, 04 Jul 2012 13:20:21 -0700 (PDT) In-Reply-To: X-detected-operating-system: by eggs.gnu.org: Genre and OS details not recognized. X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6 (newer, 3) 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:61590 Archived-At: The terms `set' and `bind', `object' and `value', and `hold' are used somewhat freely; a previous commit already prefers `bind' and `object', so this commit refines the text for the definition of a variable to prefer those too (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 f749401..a68e7a9 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 `setting', and the object to which +a variable is `set' is often called a `value' that the variable +`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