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 8a/9] doc/lispref/intro.texi: Introduce the term `value' early on Date: Fri, 06 Jul 2012 20:17:05 -0000 Message-ID: <0176eb16f5a643f89eb12633f213a542-mfwitten@gmail.com> References: <22f1c29cd7e44a3e91ca67e534dc03a4-mfwitten@gmail.com> <3c1c3c1cfe3840e19551bfd0424eb99d-mfwitten@gmail.com> <0c2cb6909a904ffeb3010bf4ca2e40b2-mfwitten@gmail.com> <85pq88c0nj.fsf@iznogoud.viz> <31927313f03b410aaa9830427ff3a0c1-mfwitten@gmail.com> NNTP-Posting-Host: plane.gmane.org X-Trace: dough.gmane.org 1341607395 28961 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:14 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 1SnFMt-0002WE-Uy for geb-bug-gnu-emacs@m.gmane.org; Fri, 06 Jul 2012 22:43:12 +0200 Original-Received: from localhost ([::1]:48439 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1SnFMt-0004eh-0e for geb-bug-gnu-emacs@m.gmane.org; Fri, 06 Jul 2012 16:43:11 -0400 Original-Received: from eggs.gnu.org ([208.118.235.92]:44828) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1SnFMo-0004ad-Pb for bug-gnu-emacs@gnu.org; Fri, 06 Jul 2012 16:43:08 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1SnFMm-0001nP-Ni for bug-gnu-emacs@gnu.org; Fri, 06 Jul 2012 16:43:06 -0400 Original-Received: from debbugs.gnu.org ([140.186.70.43]:43705) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1SnFMm-0001nJ-HF for bug-gnu-emacs@gnu.org; Fri, 06 Jul 2012 16:43:04 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.72) (envelope-from ) id 1SnFRb-0007Vk-4e for bug-gnu-emacs@gnu.org; Fri, 06 Jul 2012 16:48: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: Fri, 06 Jul 2012 20:48: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 Original-Received: via spool by 11862-submit@debbugs.gnu.org id=B11862.134160766528844 (code B ref 11862); Fri, 06 Jul 2012 20:48:03 +0000 Original-Received: (at 11862) by debbugs.gnu.org; 6 Jul 2012 20:47:45 +0000 Original-Received: from localhost ([127.0.0.1]:53249 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1SnFRJ-0007VB-6f for submit@debbugs.gnu.org; Fri, 06 Jul 2012 16:47:45 -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 1SnFRH-0007UV-Gp for 11862@debbugs.gnu.org; Fri, 06 Jul 2012 16:47:44 -0400 Original-Received: by mail-pb0-f44.google.com with SMTP id wy7so14032056pbc.3 for <11862@debbugs.gnu.org>; Fri, 06 Jul 2012 13:42:43 -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=C8q51DDYDO1kcTWmGaU0DhUXJhRdglifS9JvNqoe7/c=; b=hcU0gMa0kHnMu+GxqdgUCjtuFd8e35i1BOOZE63L/PW4N7kMGQIdDlmNnWndLRXfZ8 ZxZ0McuJ+YyKbiSv/tnm9jJGYUvdar6gsLDlHQi1EG/uYX61E8n/85ouRLtJHII3jfqL Tiba4tx8g6V9fmXnR6kH3SVAH1e/FqlleG5xdR0nEMD96a1vrHZz2kFo1QsUAz3OZ8mB uwwKbp24iXyW10IpuI0s5r+g2YMY7iQL9ooyX46adZjhuxEElybUdSizlOl9qedZ49/O Uxq1cioBXUHspmSjRfE8edZGcdpXy98JfFtrRTRVEfSf6XY3Ha0Um3YePquVFDJ1uIOl 2AJA== Original-Received: by 10.68.230.68 with SMTP id sw4mr8182264pbc.142.1341607363298; Fri, 06 Jul 2012 13:42:43 -0700 (PDT) Original-Received: from gmail.com ([188.127.231.134]) by mx.google.com with ESMTPS id hz10sm22494680pbc.32.2012.07.06.13.42.38 (version=TLSv1/SSLv3 cipher=OTHER); Fri, 06 Jul 2012 13:42:42 -0700 (PDT) In-Reply-To: <31927313f03b410aaa9830427ff3a0c1-mfwitten@gmail.com> 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:61665 Archived-At: The term `value' is used pervasively, so it should be brought to the reader's attention early on; it is introduced in node `Some Terms'. Originally, `doc/lispref/functions.texi' introduced both `@dfn{value}' and `@dfn{return value}' in describing the result of a computation, but now only `return value' is marked with `@dfn'. --- doc/lispref/functions.texi | 2 +- doc/lispref/intro.texi | 9 +++++---- 2 files changed, 6 insertions(+), 5 deletions(-) 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. diff --git a/doc/lispref/intro.texi b/doc/lispref/intro.texi index 5ca4d37..0766a23 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)}. -- 1.7.11.1.29.gf71be5c