From debbugs-submit-bounces@debbugs.gnu.org Wed Jul 04 16:22:47 2012 Received: (at submit) by debbugs.gnu.org; 4 Jul 2012 20:22:47 +0000 Received: from localhost ([127.0.0.1]:48535 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1SmW63-000655-7R for submit@debbugs.gnu.org; Wed, 04 Jul 2012 16:22:47 -0400 Received: from eggs.gnu.org ([208.118.235.92]:39875) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1SmW62-00064y-1u for submit@debbugs.gnu.org; Wed, 04 Jul 2012 16:22:46 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1SmW1L-0006Gg-SQ for submit@debbugs.gnu.org; Wed, 04 Jul 2012 16:17:57 -0400 X-Spam-Checker-Version: SpamAssassin 3.3.2 (2011-06-06) on eggs.gnu.org X-Spam-Level: X-Spam-Status: No, score=-6.5 required=5.0 tests=BAYES_00,FREEMAIL_FROM, RCVD_IN_DNSWL_HI,RCVD_IN_XBL,T_DKIM_INVALID autolearn=unavailable version=3.3.2 Received: from lists.gnu.org ([208.118.235.17]:44825) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1SmW1L-0006Gc-MX for submit@debbugs.gnu.org; Wed, 04 Jul 2012 16:17:55 -0400 Received: from eggs.gnu.org ([208.118.235.92]:40644) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1SmW1K-00051K-3s for bug-gnu-emacs@gnu.org; Wed, 04 Jul 2012 16:17:55 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1SmW1I-0006GQ-Bc for bug-gnu-emacs@gnu.org; Wed, 04 Jul 2012 16:17:53 -0400 Received: from mail-lb0-f169.google.com ([209.85.217.169]:47536) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1SmW1I-0006Fy-1q for bug-gnu-emacs@gnu.org; Wed, 04 Jul 2012 16:17:52 -0400 Received: by lbjn8 with SMTP id n8so4689818lbj.0 for ; Wed, 04 Jul 2012 13:17:49 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20120113; h=subject:date:from:to:message-id; bh=YqvxZ1SHDcOd46tG/RsLiSp32L6hIUFtZeM6xpwbEbE=; b=GayDXKwwueO2HFJYADuDjU06MGR71pL5lggPh5iu6w16RO0bdCTfhnS5c9g1J/ZBLX +ral3bPj+Op60rJECR++PhaAEaK5IMGiqAmo3dOjCyjuya30NZZiQVq3qNVypgFf1giJ gJfgvJ/eNe/n8YdnXxfPisTISueCM+heitK2t+XVIBcxh7a/mB/yn9fi8hP4J0W9S14J o/+BnRDtOP/95lp32PAmLlzI/Wh6XAGBqmNFaXNADfmLwQGd0GAmLfkUMBxA24xRwPNl B7AumdYEx1XTRs0D/MhVNvYxm/Q8RngBi5ryY9k0oLms7Z8TTFgWWjebvulwU8YSnZzZ qpuQ== Received: by 10.112.48.39 with SMTP id i7mr10882889lbn.31.1341433068867; Wed, 04 Jul 2012 13:17:48 -0700 (PDT) Received: from gmail.com (tor6.anonymizer.ccc.de. [80.237.226.76]) by mx.google.com with ESMTPS id hg4sm33915249lab.11.2012.07.04.13.17.46 (version=TLSv1/SSLv3 cipher=OTHER); Wed, 04 Jul 2012 13:17:47 -0700 (PDT) Subject: [PATCH 0/9] doc/lispref/intro.texi: Copyediting Date: Wed, 04 Jul 2012 20:15:25 -0000 From: Michael Witten To: bug-gnu-emacs@gnu.org Message-ID: 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-Received-From: 208.118.235.17 X-Spam-Score: -6.1 (------) X-Debbugs-Envelope-To: submit X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.13 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Sender: debbugs-submit-bounces@debbugs.gnu.org Errors-To: debbugs-submit-bounces@debbugs.gnu.org X-Spam-Score: -6.1 (------) Whilst reading through the Emacs Lisp reference (specifically intro.texi), I did some copyediting, which resulted in the following patch series: doc/lispref/intro.texi | 36 ++++++++++++++++++++---------------- 1 file changed, 20 insertions(+), 16 deletions(-) [1] Offset modifier with a comma [2] `can' -> `may' [3] Eradicate that pesky future tense [4] More precise language about argument types [5] Use singular form in a sentence [6] Re-fill a paragraph [7] `optional' -> `&optional'; `rest' -> `&rest' [8] More precise language for what a variable is [9] Use passive voice Patches [4], [5], and [6] could be squashed together if that is desirable Sincerely, Michael Witten -- 1.7.11.1.29.gf71be5c From debbugs-submit-bounces@debbugs.gnu.org Wed Jul 04 16:23:05 2012 Received: (at submit) by debbugs.gnu.org; 4 Jul 2012 20:23:05 +0000 Received: from localhost ([127.0.0.1]:48540 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1SmW6K-00066A-Ep for submit@debbugs.gnu.org; Wed, 04 Jul 2012 16:23:04 -0400 Received: from eggs.gnu.org ([208.118.235.92]:39910) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1SmW6I-00065l-Rj for submit@debbugs.gnu.org; Wed, 04 Jul 2012 16:23:03 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1SmW1c-0006I7-Up for submit@debbugs.gnu.org; Wed, 04 Jul 2012 16:18:14 -0400 X-Spam-Checker-Version: SpamAssassin 3.3.2 (2011-06-06) on eggs.gnu.org X-Spam-Level: X-Spam-Status: No, score=-6.5 required=5.0 tests=BAYES_00,FREEMAIL_FROM, RCVD_IN_DNSWL_HI,RCVD_IN_XBL,T_DKIM_INVALID autolearn=unavailable version=3.3.2 Received: from lists.gnu.org ([208.118.235.17]:44826) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1SmW1c-0006I3-PH for submit@debbugs.gnu.org; Wed, 04 Jul 2012 16:18:12 -0400 Received: from eggs.gnu.org ([208.118.235.92]:40673) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1SmW1b-000528-65 for bug-gnu-emacs@gnu.org; Wed, 04 Jul 2012 16:18:12 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1SmW1Z-0006Hc-CF for bug-gnu-emacs@gnu.org; Wed, 04 Jul 2012 16:18:10 -0400 Received: from mail-lb0-f169.google.com ([209.85.217.169]:47536) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1SmW1Z-0006Fy-2S for bug-gnu-emacs@gnu.org; Wed, 04 Jul 2012 16:18:09 -0400 Received: by mail-lb0-f169.google.com with SMTP id n8so4689818lbj.0 for ; Wed, 04 Jul 2012 13:18:08 -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=kes1ZJhHkOstqqOq1ouA7zXLkkcyvtuGd9iwnr74KBQ=; b=DlmrNh5unLKOv45eCQQyFuhGgLhkc/NqJsYhytzrRi0mNLKuFpmJgEY2aaAD32/m+a AzfansyYLWK899WnjDs19t7YDwJRaYbdEgCp1a55zv0z9rHSB7TlBqOn+UBYZD26f5hF 8+rvwX/3wGSaZk0cbR74vBQyNakkggWei4jjrszTyCfdU4tuIBOztPpfFkEoDbNxIs26 7jIRAbaIFbv2IRfKa0P0r5zKLoTkSh8SyEhqpb5hV/kjKg21//LfS3DZgnJCC4bn6fNT +agBqa0TJ/OvpYWXYARGo28oGnNc6ApSFL2Ke5mVjBu/W+YY7N6+EcqehFaDu9vyzkJp TCQQ== Received: by 10.112.86.166 with SMTP id q6mr10621181lbz.6.1341433087983; Wed, 04 Jul 2012 13:18:07 -0700 (PDT) Received: from gmail.com (tor6.anonymizer.ccc.de. [80.237.226.76]) by mx.google.com with ESMTPS id ta2sm33905977lab.15.2012.07.04.13.18.06 (version=TLSv1/SSLv3 cipher=OTHER); Wed, 04 Jul 2012 13:18:07 -0700 (PDT) Subject: [PATCH 1/9] doc/lispref/intro.texi: Offset modifier with a comma Date: Wed, 04 Jul 2012 20:15:39 -0000 From: Michael Witten To: bug-gnu-emacs@gnu.org Message-ID: <49c61d76f8a84f2b8ac1091b557d0864-mfwitten@gmail.com> In-Reply-To: References: 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-Received-From: 208.118.235.17 X-Spam-Score: -6.1 (------) X-Debbugs-Envelope-To: submit X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.13 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Sender: debbugs-submit-bounces@debbugs.gnu.org Errors-To: debbugs-submit-bounces@debbugs.gnu.org X-Spam-Score: -6.1 (------) --- doc/lispref/intro.texi | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/doc/lispref/intro.texi b/doc/lispref/intro.texi index 841cfac..212e604 100644 --- a/doc/lispref/intro.texi +++ b/doc/lispref/intro.texi @@ -235,7 +235,7 @@ evaluation of the expanded form. @result{} c @end example - Sometimes to help describe one form we show another form that + Sometimes to help describe one form, we show another form that produces identical results. The exact equivalence of two forms is indicated with @samp{@equiv{}}. -- 1.7.11.1.29.gf71be5c From debbugs-submit-bounces@debbugs.gnu.org Wed Jul 04 16:23:29 2012 Received: (at submit) by debbugs.gnu.org; 4 Jul 2012 20:23:30 +0000 Received: from localhost ([127.0.0.1]:48543 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1SmW6j-00066j-2g for submit@debbugs.gnu.org; Wed, 04 Jul 2012 16:23:29 -0400 Received: from eggs.gnu.org ([208.118.235.92]:40058) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1SmW6h-00066d-HB for submit@debbugs.gnu.org; Wed, 04 Jul 2012 16:23:27 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1SmW21-0006Mk-Im for submit@debbugs.gnu.org; Wed, 04 Jul 2012 16:18:38 -0400 X-Spam-Checker-Version: SpamAssassin 3.3.2 (2011-06-06) on eggs.gnu.org X-Spam-Level: X-Spam-Status: No, score=-6.5 required=5.0 tests=BAYES_00,FREEMAIL_FROM, RCVD_IN_DNSWL_HI,RCVD_IN_XBL,T_DKIM_INVALID autolearn=unavailable version=3.3.2 Received: from lists.gnu.org ([208.118.235.17]:45677) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1SmW21-0006Me-D4 for submit@debbugs.gnu.org; Wed, 04 Jul 2012 16:18:37 -0400 Received: from eggs.gnu.org ([208.118.235.92]:40811) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1SmW1z-0005UD-Pe for bug-gnu-emacs@gnu.org; Wed, 04 Jul 2012 16:18:36 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1SmW1x-0006M6-UP for bug-gnu-emacs@gnu.org; Wed, 04 Jul 2012 16:18:35 -0400 Received: from mail-lb0-f169.google.com ([209.85.217.169]:47536) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1SmW1x-0006Fy-LA for bug-gnu-emacs@gnu.org; Wed, 04 Jul 2012 16:18:33 -0400 Received: by mail-lb0-f169.google.com with SMTP id n8so4689818lbj.0 for ; Wed, 04 Jul 2012 13:18:32 -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=yuvEDZk467Bs9xdeR5KCc4v4ijEHMBTRXYdHB59veqc=; b=fLVPmlxtCyQ8/7G9csivBYEbigaoF8VofGBugy2zJOPzXlI46/Kc1iJ6jTiBXTACYZ eCK/+EOZVSq3Zf7rTkr+rjX7zzcT7Uusabr+eBXEbB/+KTgYdAoBsgO2/bL5yWl5hLyw 1eTVHH/wn1wxb6yotLW7lphvi1jvB6tPol6uWeIljQuT4wSR92H2JQkBiopIksIvKLXz 1pId7Y1egeX6q2TnnPzrEQgFoR87lJz5t1/BFwOQw+evN9fao5Ok8WuTBlK2VdH/6c4Z semf/3Eb+ig3Trld/8nj8S0HjSeO5Un1bSMtUDPPHCf8XLDYT8sFl62Z3Bt521IJdz6y EVwA== Received: by 10.152.131.37 with SMTP id oj5mr23041499lab.14.1341433112573; Wed, 04 Jul 2012 13:18:32 -0700 (PDT) Received: from gmail.com (tor6.anonymizer.ccc.de. [80.237.226.76]) by mx.google.com with ESMTPS id hi14sm33938349lab.4.2012.07.04.13.18.30 (version=TLSv1/SSLv3 cipher=OTHER); Wed, 04 Jul 2012 13:18:31 -0700 (PDT) Subject: [PATCH 2/9] doc/lispref/intro.texi: `can' -> `may' Date: Wed, 04 Jul 2012 20:15:42 -0000 From: Michael Witten To: bug-gnu-emacs@gnu.org Message-ID: <5a8b591bcd694380a2bd8d47b36d037a-mfwitten@gmail.com> In-Reply-To: References: 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-Received-From: 208.118.235.17 X-Spam-Score: -6.1 (------) X-Debbugs-Envelope-To: submit X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.13 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Sender: debbugs-submit-bounces@debbugs.gnu.org Errors-To: debbugs-submit-bounces@debbugs.gnu.org X-Spam-Score: -6.1 (------) --- doc/lispref/intro.texi | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/doc/lispref/intro.texi b/doc/lispref/intro.texi index 212e604..273945c 100644 --- a/doc/lispref/intro.texi +++ b/doc/lispref/intro.texi @@ -350,7 +350,7 @@ arguments default to @code{nil}). Do not write @code{&optional} when you call the function. The keyword @code{&rest} (which must be followed by a single -argument name) indicates that any number of arguments can follow. The +argument name) indicates that any number of arguments may follow. The single argument name following @code{&rest} will receive, as its value, a list of all the remaining arguments passed to the function. Do not write @code{&rest} when you call the function. -- 1.7.11.1.29.gf71be5c From debbugs-submit-bounces@debbugs.gnu.org Wed Jul 04 16:40:13 2012 Received: (at submit) by debbugs.gnu.org; 4 Jul 2012 20:40:13 +0000 Received: from localhost ([127.0.0.1]:48574 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1SmWMt-0006UV-Dr for submit@debbugs.gnu.org; Wed, 04 Jul 2012 16:40:13 -0400 Received: from eggs.gnu.org ([208.118.235.92]:56778) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1SmWMr-0006UF-DZ for submit@debbugs.gnu.org; Wed, 04 Jul 2012 16:40:10 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1SmWI9-000333-FO for submit@debbugs.gnu.org; Wed, 04 Jul 2012 16:35:20 -0400 X-Spam-Checker-Version: SpamAssassin 3.3.2 (2011-06-06) on eggs.gnu.org X-Spam-Level: X-Spam-Status: No, score=-6.5 required=5.0 tests=BAYES_00,FREEMAIL_FROM, RCVD_IN_DNSWL_HI,RCVD_IN_XBL,T_DKIM_INVALID autolearn=unavailable version=3.3.2 Received: from lists.gnu.org ([208.118.235.17]:47215) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1SmWI9-0002x9-9Q for submit@debbugs.gnu.org; Wed, 04 Jul 2012 16:35:17 -0400 Received: from eggs.gnu.org ([208.118.235.92]:60742) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1SmW3V-0005kY-Io for bug-gnu-emacs@gnu.org; Wed, 04 Jul 2012 16:20:10 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1SmW3T-0006vN-Me for bug-gnu-emacs@gnu.org; Wed, 04 Jul 2012 16:20:08 -0400 Received: from mail-lb0-f169.google.com ([209.85.217.169]:47536) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1SmW3T-0006Fy-DA for bug-gnu-emacs@gnu.org; Wed, 04 Jul 2012 16:20:07 -0400 Received: by mail-lb0-f169.google.com with SMTP id n8so4689818lbj.0 for ; Wed, 04 Jul 2012 13:20:06 -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=rz+ecdENe12b4AdZQM4+S19UIi08gKQFOaPfUUB/2pw=; b=EAXVL6qaXfBGdfmYOohun/c+qb9jdOynng52V9ZiDYYWE/lS6na6N4JUQtN20jwd61 /RKF6ZpXZMRa1L1Rh554cssEGaEhlRt2TjeSbx+Gc8RqQx2t6+uHd4JQWt7H1DXjYNGj CTCmLdB1iV8OR2peLJdR2kKOgciVc/AEl4wYxq45M8Mioaa9+7UqP7RNREkjRieVzz8T SW7x74dYSzdq9exEHvctVm38gTGFOmBrE31VnsQWZbGoWoJbJibDcROZvKie18L/EHFm cq+AeqA0IwJ/lWEghpd/+h5cWCy6OtsXnhPErsmlQiLDSMMMqQR2BLd3dkp0gmfjc6s2 fQOQ== Received: by 10.112.49.100 with SMTP id t4mr10630259lbn.10.1341433206205; Wed, 04 Jul 2012 13:20:06 -0700 (PDT) Received: from gmail.com (tor6.anonymizer.ccc.de. [80.237.226.76]) by mx.google.com with ESMTPS id mo3sm33951351lab.2.2012.07.04.13.20.04 (version=TLSv1/SSLv3 cipher=OTHER); Wed, 04 Jul 2012 13:20:05 -0700 (PDT) Subject: [PATCH 7/9] doc/lispref/intro.texi: `optional' -> `&optional'; Date: Wed, 04 Jul 2012 20:15:57 -0000 From: Michael Witten To: bug-gnu-emacs@gnu.org Message-ID: <4d292c93e5534360a5355aba84b8d5f0-mfwitten@gmail.com> In-Reply-To: References: 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-Received-From: 208.118.235.17 X-Spam-Score: -6.1 (------) X-Debbugs-Envelope-To: submit X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.13 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Sender: debbugs-submit-bounces@debbugs.gnu.org Errors-To: debbugs-submit-bounces@debbugs.gnu.org X-Spam-Score: -6.1 (------) In particular, the word `rest' as used in the original text is quite jarring to read, so the more explicit `&rest' is introduced by this commit. For completeness, the word `optional' is likewise replaced with `&optional'. Also, a spurious comma after the cross reference has been removed, and the word ordering rearranged for simplicity. --- doc/lispref/intro.texi | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/doc/lispref/intro.texi b/doc/lispref/intro.texi index f680688..f749401 100644 --- a/doc/lispref/intro.texi +++ b/doc/lispref/intro.texi @@ -390,8 +390,8 @@ specifically in the description of the function. In some sections, features common to the arguments of several functions are described at the beginning. - @xref{Lambda Expressions}, for a more complete description of optional -and rest arguments. + @xref{Lambda Expressions} for a more complete description of arguments +modified by @code{&optional} and @code{&rest}. Command, macro, and special form descriptions have the same format, but the word `Function' is replaced by `Command', `Macro', or `Special -- 1.7.11.1.29.gf71be5c From debbugs-submit-bounces@debbugs.gnu.org Wed Jul 04 16:40:15 2012 Received: (at submit) by debbugs.gnu.org; 4 Jul 2012 20:40:15 +0000 Received: from localhost ([127.0.0.1]:48579 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1SmWMv-0006Ul-4H for submit@debbugs.gnu.org; Wed, 04 Jul 2012 16:40:15 -0400 Received: from eggs.gnu.org ([208.118.235.92]:56793) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1SmWMr-0006UI-Mb for submit@debbugs.gnu.org; Wed, 04 Jul 2012 16:40:10 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1SmWI9-00033Y-NV for submit@debbugs.gnu.org; Wed, 04 Jul 2012 16:35:20 -0400 X-Spam-Checker-Version: SpamAssassin 3.3.2 (2011-06-06) on eggs.gnu.org X-Spam-Level: X-Spam-Status: No, score=-6.5 required=5.0 tests=BAYES_00,FREEMAIL_FROM, RCVD_IN_DNSWL_HI,RCVD_IN_XBL,T_DKIM_INVALID autolearn=unavailable version=3.3.2 Received: from lists.gnu.org ([208.118.235.17]:47202) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1SmWI9-0002x1-Hw for submit@debbugs.gnu.org; Wed, 04 Jul 2012 16:35:17 -0400 Received: from eggs.gnu.org ([208.118.235.92]:40973) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1SmW2q-0005f1-SJ for bug-gnu-emacs@gnu.org; Wed, 04 Jul 2012 16:19:30 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1SmW2p-0006g0-2b for bug-gnu-emacs@gnu.org; Wed, 04 Jul 2012 16:19:28 -0400 Received: from mail-lb0-f169.google.com ([209.85.217.169]:47536) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1SmW2o-0006Fy-PG for bug-gnu-emacs@gnu.org; Wed, 04 Jul 2012 16:19:27 -0400 Received: by mail-lb0-f169.google.com with SMTP id n8so4689818lbj.0 for ; Wed, 04 Jul 2012 13:19:25 -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=6psGYivFLDvoi128cmtmia8HMS1AnuWdLww3s2bEcos=; b=qXtvfAT/OJ+MjK0IAjwOsdpN4JknFhPPU2ILxvdRovaCJzYZEweGT0jGdMArsoXt+s bgn/0aFGf3rBxOMIw6ylo/3wFERMUk6N6+PYxuxqoXxSyHc+kInvnphhGukAuzgbf9mC bYe6gyFgPQxR8dH7HROOl9B/vgBHXXb8XdEoLIUqPEJ/yv7MPyyfOhV1Tj064djpfIgm AHMssqha3iGPSKVFiJDDOss77RTFzFTUZCfFwtqlLWlTTCDvtu6AVLGorFkJrMiEM2k0 IHWT9Elwey645c9/aBzYpyUxLnmDvyLJBKgjoAdws1HgPAGqhozQfJ/I9s8N7uyx7aFT LQmw== Received: by 10.112.85.42 with SMTP id e10mr10343343lbz.17.1341433165729; Wed, 04 Jul 2012 13:19:25 -0700 (PDT) Received: from gmail.com (tor6.anonymizer.ccc.de. [80.237.226.76]) by mx.google.com with ESMTPS id gv8sm33910978lab.14.2012.07.04.13.19.23 (version=TLSv1/SSLv3 cipher=OTHER); Wed, 04 Jul 2012 13:19:24 -0700 (PDT) Subject: [PATCH 5/9] doc/lispref/intro.texi: Use singular form in a sentence Date: Wed, 04 Jul 2012 20:15:50 -0000 From: Michael Witten To: bug-gnu-emacs@gnu.org Message-ID: <84a2719ab5de4be88157f1bd670e633c-mfwitten@gmail.com> In-Reply-To: References: 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-Received-From: 208.118.235.17 X-Spam-Score: -6.1 (------) X-Debbugs-Envelope-To: submit X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.13 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Sender: debbugs-submit-bounces@debbugs.gnu.org Errors-To: debbugs-submit-bounces@debbugs.gnu.org X-Spam-Score: -6.1 (------) It's often more precise to describe the general case by using a singular subject. (The paragraph should be re-filled by a future commit.) --- doc/lispref/intro.texi | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/doc/lispref/intro.texi b/doc/lispref/intro.texi index 50e6712..a5a9747 100644 --- a/doc/lispref/intro.texi +++ b/doc/lispref/intro.texi @@ -385,8 +385,8 @@ bound to an object of that type. A plural of a type (such as @var{buffers}) often means a list of objects of that type. An argument named with the type @var{object} may be bound to an object of any type. -(@xref{Lisp Data Types}, for a list of Emacs object types.) Arguments -with other sorts of names (e.g., @var{new-file}) are discussed +(@xref{Lisp Data Types} for a list of Emacs object types.) An argument +with some other sort of name (e.g., @var{new-file}) is discussed specifically in the description of the function. In some sections, features common to the arguments of several functions are described at the beginning. -- 1.7.11.1.29.gf71be5c From debbugs-submit-bounces@debbugs.gnu.org Wed Jul 04 16:40:17 2012 Received: (at submit) by debbugs.gnu.org; 4 Jul 2012 20:40:17 +0000 Received: from localhost ([127.0.0.1]:48581 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1SmWMx-0006V1-GS for submit@debbugs.gnu.org; Wed, 04 Jul 2012 16:40:17 -0400 Received: from eggs.gnu.org ([208.118.235.92]:56797) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1SmWMr-0006UJ-Vx for submit@debbugs.gnu.org; Wed, 04 Jul 2012 16:40:11 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1SmWI9-00033M-LS for submit@debbugs.gnu.org; Wed, 04 Jul 2012 16:35:20 -0400 X-Spam-Checker-Version: SpamAssassin 3.3.2 (2011-06-06) on eggs.gnu.org X-Spam-Level: X-Spam-Status: No, score=-6.5 required=5.0 tests=BAYES_00,FREEMAIL_FROM, RCVD_IN_DNSWL_HI,RCVD_IN_XBL,T_DKIM_INVALID autolearn=unavailable version=3.3.2 Received: from lists.gnu.org ([208.118.235.17]:47196) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1SmWI9-0002wo-EZ for submit@debbugs.gnu.org; Wed, 04 Jul 2012 16:35:17 -0400 Received: from eggs.gnu.org ([208.118.235.92]:41033) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1SmW36-0005fR-QC for bug-gnu-emacs@gnu.org; Wed, 04 Jul 2012 16:19:45 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1SmW34-0006hc-Oa for bug-gnu-emacs@gnu.org; Wed, 04 Jul 2012 16:19:44 -0400 Received: from mail-lb0-f169.google.com ([209.85.217.169]:47536) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1SmW34-0006Fy-AU for bug-gnu-emacs@gnu.org; Wed, 04 Jul 2012 16:19:42 -0400 Received: by mail-lb0-f169.google.com with SMTP id n8so4689818lbj.0 for ; Wed, 04 Jul 2012 13:19:41 -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=k8/bWh/I8ckj/hoZlwr4HRVuNddBGOmV8rdB393Bt9k=; b=ntmR3LyKsi3KJgUxAmTznzPMHZEIO3Q4JTm9v7UGlD924R8UcEBZe3OIf/9uBtwKDb 3ubWhFSS9I4/dy69B5UcTffzLNyjdTHk9uxI5QXkNduTAw5NCWdF7RTLjAL5evoDH3Na s1um8dp2G57+r+uDBl8WL3XEuGt/BolecdfLgAfOSJqWMmNZpNaTLeCz0WGJltOyH1mB BnJ2F1gaANiktJMCRid4WK3tMYLZlhH//hJDo3muBf/O+nSQPr0BupbRGZeN2Gc2vv3F ly7dAKjr9Mq6wHGyK1QQ+1ClI/oWB6aVbTUbppaW880Is/rsYyYVXgYYtYH+A11lcYGg V4Bw== Received: by 10.152.144.138 with SMTP id sm10mr19238281lab.22.1341433181345; Wed, 04 Jul 2012 13:19:41 -0700 (PDT) Received: from gmail.com (tor6.anonymizer.ccc.de. [80.237.226.76]) by mx.google.com with ESMTPS id fv16sm33923911lab.9.2012.07.04.13.19.39 (version=TLSv1/SSLv3 cipher=OTHER); Wed, 04 Jul 2012 13:19:40 -0700 (PDT) Subject: [PATCH 6/9] doc/lispref/intro.texi: Re-fill a paragraph Date: Wed, 04 Jul 2012 20:15:54 -0000 From: Michael Witten To: bug-gnu-emacs@gnu.org Message-ID: <2153031089274659ac14d44c52365f68-mfwitten@gmail.com> In-Reply-To: References: 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-Received-From: 208.118.235.17 X-Spam-Score: -6.1 (------) X-Debbugs-Envelope-To: submit X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.13 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Sender: debbugs-submit-bounces@debbugs.gnu.org Errors-To: debbugs-submit-bounces@debbugs.gnu.org X-Spam-Score: -6.1 (------) Some previous commits altered the text in a way that left this particular paragraph with some rather unfortunately placed hard newlines. This commit undoes that damage. --- doc/lispref/intro.texi | 9 ++++----- 1 file changed, 4 insertions(+), 5 deletions(-) diff --git a/doc/lispref/intro.texi b/doc/lispref/intro.texi index a5a9747..f680688 100644 --- a/doc/lispref/intro.texi +++ b/doc/lispref/intro.texi @@ -380,11 +380,10 @@ More generally, @end defun Any argument whose name contains the name of a type (e.g., -@var{integer}, @var{integer1} or @var{buffer}) is expected to be -bound to an object of that -type. A plural of a type (such as @var{buffers}) often means a list of -objects of that type. An argument named with the type @var{object} may be -bound to an object of any type. +@var{integer}, @var{integer1} or @var{buffer}) is expected to be bound +to an object of that type. A plural of a type (such as @var{buffers}) +often means a list of objects of that type. An argument named with the +type @var{object} may be bound to an object of any type. (@xref{Lisp Data Types} for a list of Emacs object types.) An argument with some other sort of name (e.g., @var{new-file}) is discussed specifically in the description of the function. In some sections, -- 1.7.11.1.29.gf71be5c From debbugs-submit-bounces@debbugs.gnu.org Wed Jul 04 16:40:18 2012 Received: (at submit) by debbugs.gnu.org; 4 Jul 2012 20:40:18 +0000 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 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 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 X-Spam-Checker-Version: SpamAssassin 3.3.2 (2011-06-06) on eggs.gnu.org X-Spam-Level: X-Spam-Status: No, score=-6.5 required=5.0 tests=BAYES_00,FREEMAIL_FROM, RCVD_IN_DNSWL_HI,RCVD_IN_XBL,T_DKIM_INVALID autolearn=unavailable version=3.3.2 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 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 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 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 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== Received: by 10.112.83.229 with SMTP id t5mr10724502lby.8.1341433222642; Wed, 04 Jul 2012 13:20:22 -0700 (PDT) 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) Subject: [PATCH 8/9] doc/lispref/intro.texi: More precise language for Date: Wed, 04 Jul 2012 20:15:59 -0000 From: Michael Witten To: bug-gnu-emacs@gnu.org Message-ID: <22f1c29cd7e44a3e91ca67e534dc03a4-mfwitten@gmail.com> In-Reply-To: References: 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-Received-From: 208.118.235.17 X-Spam-Score: -6.1 (------) X-Debbugs-Envelope-To: submit X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.13 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Sender: debbugs-submit-bounces@debbugs.gnu.org Errors-To: debbugs-submit-bounces@debbugs.gnu.org X-Spam-Score: -6.1 (------) 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 From debbugs-submit-bounces@debbugs.gnu.org Wed Jul 04 16:40:18 2012 Received: (at submit) by debbugs.gnu.org; 4 Jul 2012 20:40:18 +0000 Received: from localhost ([127.0.0.1]:48585 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1SmWMz-0006VK-W0 for submit@debbugs.gnu.org; Wed, 04 Jul 2012 16:40:18 -0400 Received: from eggs.gnu.org ([208.118.235.92]:56864) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1SmWMt-0006UX-RA for submit@debbugs.gnu.org; Wed, 04 Jul 2012 16:40:14 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1SmWIB-00037B-O3 for submit@debbugs.gnu.org; Wed, 04 Jul 2012 16:35:23 -0400 X-Spam-Checker-Version: SpamAssassin 3.3.2 (2011-06-06) on eggs.gnu.org X-Spam-Level: X-Spam-Status: No, score=-6.5 required=5.0 tests=BAYES_00,FREEMAIL_FROM, RCVD_IN_DNSWL_HI,RCVD_IN_XBL,T_DKIM_INVALID autolearn=unavailable version=3.3.2 Received: from lists.gnu.org ([208.118.235.17]:47202) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1SmWIB-0002x1-HV for submit@debbugs.gnu.org; Wed, 04 Jul 2012 16:35:19 -0400 Received: from eggs.gnu.org ([208.118.235.92]:40902) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1SmW2Z-0005VI-LT for bug-gnu-emacs@gnu.org; Wed, 04 Jul 2012 16:19:13 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1SmW2X-0006db-Sc for bug-gnu-emacs@gnu.org; Wed, 04 Jul 2012 16:19:11 -0400 Received: from mail-lb0-f169.google.com ([209.85.217.169]:47536) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1SmW2X-0006Fy-IE for bug-gnu-emacs@gnu.org; Wed, 04 Jul 2012 16:19:09 -0400 Received: by mail-lb0-f169.google.com with SMTP id n8so4689818lbj.0 for ; Wed, 04 Jul 2012 13:19:08 -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=KMZWSmVD1cr40ydf2atvnPE9A5z7pqc+YJAA/uDMocI=; b=fwEkx72vx2cXZkvZyLMxBQvgLBX17rAmC13xYmCXdPpLJOtQMHmMTlf7sZos6if2WK brGv1MGosxADngWKEWxtJpq29opjqvK7xOk+KzKEScAx0759egUulbRRdyyMMpQ6TmNR VOpe+9HAKKJLsbD5z/w25u4bez2bYfX9L8HIuin62DajD9bWBq0oOOiNNkr9/vvhYCGW 6NQ47RMBmzh6dzlzoUqwKJx4F89R2H5pUd6GG4WgTs9RqqscbCF7cWTTzMoRbm3tSwJy u8If9np58u14u/55UNPGJskJLgUQJCwIimofDPIphT32qCfuSIrljEv2lkvDsNzz0f1C ePQg== Received: by 10.112.17.227 with SMTP id r3mr10607816lbd.41.1341433148448; Wed, 04 Jul 2012 13:19:08 -0700 (PDT) Received: from gmail.com (tor6.anonymizer.ccc.de. [80.237.226.76]) by mx.google.com with ESMTPS id ta2sm33907921lab.15.2012.07.04.13.19.06 (version=TLSv1/SSLv3 cipher=OTHER); Wed, 04 Jul 2012 13:19:07 -0700 (PDT) Subject: [PATCH 4/9] doc/lispref/intro.texi: More precise language Date: Wed, 04 Jul 2012 20:15:48 -0000 From: Michael Witten To: bug-gnu-emacs@gnu.org Message-ID: <5d871479d57e4d94a538f7f27be2c620-mfwitten@gmail.com> In-Reply-To: References: 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-Received-From: 208.118.235.17 X-Spam-Score: -6.1 (------) X-Debbugs-Envelope-To: submit X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.13 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Sender: debbugs-submit-bounces@debbugs.gnu.org Errors-To: debbugs-submit-bounces@debbugs.gnu.org X-Spam-Score: -6.1 (------) When a type is specified in the description of a function's argument, it is the object to which that argument is bound (rather than the argument itself) that is expected to be of that type; this is a bit pedantic, but, hey! This is a reference manual. (The paragraph should be re-filled by a future commit.) --- doc/lispref/intro.texi | 6 ++++-- 1 file changed, 4 insertions(+), 2 deletions(-) diff --git a/doc/lispref/intro.texi b/doc/lispref/intro.texi index 4f0f8cd..50e6712 100644 --- a/doc/lispref/intro.texi +++ b/doc/lispref/intro.texi @@ -380,9 +380,11 @@ More generally, @end defun Any argument whose name contains the name of a type (e.g., -@var{integer}, @var{integer1} or @var{buffer}) is expected to be of that +@var{integer}, @var{integer1} or @var{buffer}) is expected to be +bound to an object of that type. A plural of a type (such as @var{buffers}) often means a list of -objects of that type. Arguments named @var{object} may be of any type. +objects of that type. An argument named with the type @var{object} may be +bound to an object of any type. (@xref{Lisp Data Types}, for a list of Emacs object types.) Arguments with other sorts of names (e.g., @var{new-file}) are discussed specifically in the description of the function. In some sections, -- 1.7.11.1.29.gf71be5c From debbugs-submit-bounces@debbugs.gnu.org Wed Jul 04 16:40:19 2012 Received: (at submit) by debbugs.gnu.org; 4 Jul 2012 20:40:19 +0000 Received: from localhost ([127.0.0.1]:48587 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1SmWN0-0006VS-HK for submit@debbugs.gnu.org; Wed, 04 Jul 2012 16:40:18 -0400 Received: from eggs.gnu.org ([208.118.235.92]:56869) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1SmWMu-0006Uc-9Q for submit@debbugs.gnu.org; Wed, 04 Jul 2012 16:40:14 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1SmWIB-00037g-VV for submit@debbugs.gnu.org; Wed, 04 Jul 2012 16:35:23 -0400 X-Spam-Checker-Version: SpamAssassin 3.3.2 (2011-06-06) on eggs.gnu.org X-Spam-Level: X-Spam-Status: No, score=-6.5 required=5.0 tests=BAYES_00,FREEMAIL_FROM, RCVD_IN_DNSWL_HI,RCVD_IN_XBL,T_DKIM_INVALID autolearn=unavailable version=3.3.2 Received: from lists.gnu.org ([208.118.235.17]:47215) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1SmWIB-0002x9-OQ for submit@debbugs.gnu.org; Wed, 04 Jul 2012 16:35:19 -0400 Received: from eggs.gnu.org ([208.118.235.92]:40877) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1SmW2I-0005Uw-OP for bug-gnu-emacs@gnu.org; Wed, 04 Jul 2012 16:18:55 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1SmW2G-0006O4-PO for bug-gnu-emacs@gnu.org; Wed, 04 Jul 2012 16:18:54 -0400 Received: from mail-lb0-f169.google.com ([209.85.217.169]:47536) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1SmW2G-0006Fy-FW for bug-gnu-emacs@gnu.org; Wed, 04 Jul 2012 16:18:52 -0400 Received: by mail-lb0-f169.google.com with SMTP id n8so4689818lbj.0 for ; Wed, 04 Jul 2012 13:18:51 -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=QxfPfurHD6meXK981N+wUwCUDRh6Exs6t3x0fibWhwM=; b=O+nkcG9qY0FEJianWJ19t6c9deZxfbHz5ED1zT46RpD7k4F4KKI8FGLHRDT9WUUVvW DCcYoKtJ89Tl30NTrQOxKCmbwyt6NwIG7vzXS5WhbHp3fwOsuZsOKtR4vUDd0NQQKiY+ /BmKF/nsooSpMJL5oKOWc08EAPuDdMT2k6/Ank/BNlQ27PhfTOWu8bxZTejf3CelqdQX FEaLe/D/jRdyOePtOcA9REnbm4a/60vdOezvKUxTAnxbImAuI1I+XXYXxO2hH2sWxhBa rBywXhiuXj2oNbjXFaMJyi4RNKZfbk4+mhDPgnhmeScFj3p73rE1V4COzOZFJPimDwtO dyvg== Received: by 10.112.82.197 with SMTP id k5mr9789037lby.98.1341433131448; Wed, 04 Jul 2012 13:18:51 -0700 (PDT) Received: from gmail.com (tor6.anonymizer.ccc.de. [80.237.226.76]) by mx.google.com with ESMTPS id gi19sm33904541lab.16.2012.07.04.13.18.49 (version=TLSv1/SSLv3 cipher=OTHER); Wed, 04 Jul 2012 13:18:50 -0700 (PDT) Subject: [PATCH 3/9] doc/lispref/intro.texi: Eradicate that pesky future tense Date: Wed, 04 Jul 2012 20:15:45 -0000 From: Michael Witten To: bug-gnu-emacs@gnu.org Message-ID: In-Reply-To: References: 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-Received-From: 208.118.235.17 X-Spam-Score: -6.1 (------) X-Debbugs-Envelope-To: submit X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.13 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Sender: debbugs-submit-bounces@debbugs.gnu.org Errors-To: debbugs-submit-bounces@debbugs.gnu.org X-Spam-Score: -6.1 (------) Universal and eternal truths are better represented with the present tense. --- doc/lispref/intro.texi | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/doc/lispref/intro.texi b/doc/lispref/intro.texi index 273945c..4f0f8cd 100644 --- a/doc/lispref/intro.texi +++ b/doc/lispref/intro.texi @@ -351,7 +351,7 @@ you call the function. The keyword @code{&rest} (which must be followed by a single argument name) indicates that any number of arguments may follow. The -single argument name following @code{&rest} will receive, as its +single argument name following @code{&rest} receives, as its value, a list of all the remaining arguments passed to the function. Do not write @code{&rest} when you call the function. -- 1.7.11.1.29.gf71be5c From debbugs-submit-bounces@debbugs.gnu.org Wed Jul 04 16:40:19 2012 Received: (at submit) by debbugs.gnu.org; 4 Jul 2012 20:40:19 +0000 Received: from localhost ([127.0.0.1]:48589 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1SmWN1-0006VX-3j for submit@debbugs.gnu.org; Wed, 04 Jul 2012 16:40:19 -0400 Received: from eggs.gnu.org ([208.118.235.92]:56871) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1SmWMu-0006Ud-E0 for submit@debbugs.gnu.org; Wed, 04 Jul 2012 16:40:16 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1SmWI9-00032m-Aj for submit@debbugs.gnu.org; Wed, 04 Jul 2012 16:35:23 -0400 X-Spam-Checker-Version: SpamAssassin 3.3.2 (2011-06-06) on eggs.gnu.org X-Spam-Level: X-Spam-Status: No, score=-6.5 required=5.0 tests=BAYES_00,FREEMAIL_FROM, RCVD_IN_DNSWL_HI,RCVD_IN_XBL,T_DKIM_INVALID autolearn=unavailable version=3.3.2 Received: from lists.gnu.org ([208.118.235.17]:47196) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1SmWI9-0002wo-3i for submit@debbugs.gnu.org; Wed, 04 Jul 2012 16:35:17 -0400 Received: from eggs.gnu.org ([208.118.235.92]:60802) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1SmW43-0005lF-1j for bug-gnu-emacs@gnu.org; Wed, 04 Jul 2012 16:20:44 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1SmW40-0007BJ-Rv for bug-gnu-emacs@gnu.org; Wed, 04 Jul 2012 16:20:42 -0400 Received: from mail-lb0-f169.google.com ([209.85.217.169]:47536) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1SmW40-0006Fy-I4 for bug-gnu-emacs@gnu.org; Wed, 04 Jul 2012 16:20:40 -0400 Received: by mail-lb0-f169.google.com with SMTP id n8so4689818lbj.0 for ; Wed, 04 Jul 2012 13:20:39 -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=XWcEuOoQBhkt4jyivRSBqlyubgkAeq4c7iMpxPtk/DA=; b=MOjNTIn5OZmCFjwxqwnOK608w31EvoNGeGlGsunx/zhiRQnxad+cmX5T2TMpJD8yC+ lkdZXb6qsthOzlEfzvRn9q43VOXyyS//Tmvnd8XItXz7IwF6voHa0J5UUThVD8cVPBZf zrGYzuibIsbIfc6Aaq1ZkeW/4l1+mtXKHmLGFXwGs4ZJHomAKz48jwDVqDUvugyCvG/c asYjKXuPx5mwrdL4tIqp964EbsxwI0AkFtu8pDeB+F1WjHVUBNOfx3zD7JVwG/OEDihC PgOinA2mHocvG86dTBQoArLxDFcyriu4cH5kMnbxdYv/ClpEw4gVK9lNROyXQwdBxH98 fOJQ== Received: by 10.152.104.171 with SMTP id gf11mr14605161lab.5.1341433239470; Wed, 04 Jul 2012 13:20:39 -0700 (PDT) Received: from gmail.com (tor6.anonymizer.ccc.de. [80.237.226.76]) by mx.google.com with ESMTPS id pe8sm33904674lab.17.2012.07.04.13.20.37 (version=TLSv1/SSLv3 cipher=OTHER); Wed, 04 Jul 2012 13:20:38 -0700 (PDT) Subject: [PATCH 9/9] doc/lispref/intro.texi: Use passive voice Date: Wed, 04 Jul 2012 20:16:07 -0000 From: Michael Witten To: bug-gnu-emacs@gnu.org Message-ID: <51e3eb5ff6ec469b84839dcede4eb072-mfwitten@gmail.com> In-Reply-To: References: 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-Received-From: 208.118.235.17 X-Spam-Score: -6.1 (------) X-Debbugs-Envelope-To: submit X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.13 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Sender: debbugs-submit-bounces@debbugs.gnu.org Errors-To: debbugs-submit-bounces@debbugs.gnu.org X-Spam-Score: -6.1 (------) There's no value in using `you' as the subject here, especially given that the surrounding text doesn't do so. --- doc/lispref/intro.texi | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/doc/lispref/intro.texi b/doc/lispref/intro.texi index a68e7a9..da39375 100644 --- a/doc/lispref/intro.texi +++ b/doc/lispref/intro.texi @@ -508,7 +508,7 @@ emacs-build-time The value of this variable is the version of Emacs being run. It is a string such as @code{"23.1.1"}. The last number in this string is not really part of the Emacs release version number; it is incremented -each time you build Emacs in any given directory. A value with four +each time Emacs is built in any given directory. A value with four numeric components, such as @code{"22.0.91.1"}, indicates an unreleased test version. @end defvar -- 1.7.11.1.29.gf71be5c From debbugs-submit-bounces@debbugs.gnu.org Wed Jul 04 22:57:47 2012 Received: (at 11862-done) by debbugs.gnu.org; 5 Jul 2012 02:57:47 +0000 Received: from localhost ([127.0.0.1]:49088 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1SmcGJ-0007Gc-GC for submit@debbugs.gnu.org; Wed, 04 Jul 2012 22:57:47 -0400 Received: from ironport2-out.teksavvy.com ([206.248.154.182]:59690) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1SmcGG-0007GU-MV for 11862-done@debbugs.gnu.org; Wed, 04 Jul 2012 22:57:45 -0400 X-IronPort-Anti-Spam-Filtered: true X-IronPort-Anti-Spam-Result: Av0EAG6Zu09MCquH/2dsb2JhbABEtBGBCIIVAQEEAVYjBQsLDiYSFBgNJIgcBboJkEQDozOBWIMF X-IronPort-AV: E=Sophos;i="4.75,637,1330923600"; d="scan'208";a="192714535" Received: from 76-10-171-135.dsl.teksavvy.com (HELO pastel.home) ([76.10.171.135]) by ironport2-out.teksavvy.com with ESMTP/TLS/ADH-AES256-SHA; 04 Jul 2012 22:52:53 -0400 Received: by pastel.home (Postfix, from userid 20848) id 362E959751; Wed, 4 Jul 2012 22:52:53 -0400 (EDT) From: Stefan Monnier To: Michael Witten Subject: Re: bug#11862: [PATCH 0/9] doc/lispref/intro.texi: Copyediting Message-ID: References: Date: Wed, 04 Jul 2012 22:52:53 -0400 In-Reply-To: (Michael Witten's message of "Wed, 04 Jul 2012 20:15:25 -0000") User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/24.1.50 (gnu/linux) MIME-Version: 1.0 Content-Type: text/plain X-Spam-Score: -1.9 (-) X-Debbugs-Envelope-To: 11862-done Cc: 11862-done@debbugs.gnu.org X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.13 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Sender: debbugs-submit-bounces@debbugs.gnu.org Errors-To: debbugs-submit-bounces@debbugs.gnu.org X-Spam-Score: -1.9 (-) > Whilst reading through the Emacs Lisp reference (specifically intro.texi), > I did some copyediting, which resulted in the following patch series: Thank you, installed, Stefan From debbugs-submit-bounces@debbugs.gnu.org Wed Jul 04 23:08:15 2012 Received: (at 11862) by debbugs.gnu.org; 5 Jul 2012 03:08:15 +0000 Received: from localhost ([127.0.0.1]:49174 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1SmcQQ-0007Xl-2c for submit@debbugs.gnu.org; Wed, 04 Jul 2012 23:08:15 -0400 Received: from fencepost.gnu.org ([208.118.235.10]:46806) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1SmcQM-0007Xc-Jt for 11862@debbugs.gnu.org; Wed, 04 Jul 2012 23:08:11 -0400 Received: from rgm by fencepost.gnu.org with local (Exim 4.71) (envelope-from ) id 1SmcLd-00055Y-QM; Wed, 04 Jul 2012 23:03:17 -0400 From: Glenn Morris To: Michael Witten Subject: Re: bug#11862: [PATCH 7/9] doc/lispref/intro.texi: `optional' -> `&optional'; References: <4d292c93e5534360a5355aba84b8d5f0-mfwitten@gmail.com> X-Spook: Islam Abduganievich Karimov AK-47 freedom Leitrim USCODE X-Ran: VQA$EUzKdL2\8^(jOkGXH!%xOmA3\^7BeW}x?kF/+VH%Zh-X9}B_p&1-1eM]MxQKb#Be.J X-Hue: magenta X-Debbugs-No-Ack: yes X-Attribution: GM Date: Wed, 04 Jul 2012 23:03:17 -0400 In-Reply-To: <4d292c93e5534360a5355aba84b8d5f0-mfwitten@gmail.com> (Michael Witten's message of "Wed, 04 Jul 2012 20:15:57 -0000") Message-ID: User-Agent: Gnus (www.gnus.org), GNU Emacs (www.gnu.org/software/emacs/) MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Spam-Score: -6.9 (------) X-Debbugs-Envelope-To: 11862 Cc: 11862@debbugs.gnu.org X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.13 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Sender: debbugs-submit-bounces@debbugs.gnu.org Errors-To: debbugs-submit-bounces@debbugs.gnu.org X-Spam-Score: -6.9 (------) Michael Witten wrote: > Also, a spurious comma after the cross reference has been removed, It was not spurious. doc/lispref/intro.texi:387: warning: `.' or `,' must follow @xref, not `f'. doc/lispref/intro.texi:393: warning: `.' or `,' must follow @xref, not `f'. > - @xref{Lambda Expressions}, for a more complete description of optional > -and rest arguments. > + @xref{Lambda Expressions} for a more complete description of arguments > +modified by @code{&optional} and @code{&rest}. From debbugs-submit-bounces@debbugs.gnu.org Thu Jul 05 00:41:52 2012 Received: (at 11862-done) by debbugs.gnu.org; 5 Jul 2012 04:41:52 +0000 Received: from localhost ([127.0.0.1]:49295 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1Smdt1-00017v-Oe for submit@debbugs.gnu.org; Thu, 05 Jul 2012 00:41:52 -0400 Received: from mail-qa0-f44.google.com ([209.85.216.44]:43092) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1Smdsz-00017o-2z for 11862-done@debbugs.gnu.org; Thu, 05 Jul 2012 00:41:49 -0400 Received: by qadz3 with SMTP id z3so3903960qad.3 for <11862-done@debbugs.gnu.org>; Wed, 04 Jul 2012 21:36:58 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20120113; h=mime-version:in-reply-to:references:from:date:message-id:subject:to :cc:content-type; bh=Noec8EXQ8RHVU779Cx+egdAJj5pnnp1NWRHUDjKLGZE=; b=Nc048m9GF0YpTu7TkueCajKHS+G5y8qGpzbby+0pnZJ1gg3ix2PVNN0xtY6FumoCUL Pp0rrrnwiYajyNwy0m8VDAFIsoyTTvxh9gaDUwb1Lw5D1RfAnxSLDmdgMip+rHo+UnEC 1wV8inhbw6CpL/f2qiCollnN89tTqDw9+xM3g+a0d+7bdoaxtaAA48vSKC+Q1NgvsmcS EAJ4gyfZtFOeLt6eGCGcd3nRtrR6LlP9ZOijgNCX1+WJ+zCMBatucGBHIkI4DrHqZCNT zP9lxuqMTle5shZu82wSwP+DLwxqd8EP6yRpoFxxPlz2tsShX7MdVk7VWXxwz0y7HbtJ YCdg== Received: by 10.224.191.3 with SMTP id dk3mr42424552qab.99.1341463018176; Wed, 04 Jul 2012 21:36:58 -0700 (PDT) MIME-Version: 1.0 Received: by 10.229.241.1 with HTTP; Wed, 4 Jul 2012 21:36:27 -0700 (PDT) In-Reply-To: References: From: Michael Witten Date: Thu, 5 Jul 2012 04:36:27 +0000 Message-ID: Subject: Re: bug#11862: [PATCH 0/9] doc/lispref/intro.texi: Copyediting To: Stefan Monnier Content-Type: text/plain; charset=UTF-8 X-Spam-Score: -2.6 (--) X-Debbugs-Envelope-To: 11862-done Cc: Glenn Morris , 11862-done@debbugs.gnu.org X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.13 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Sender: debbugs-submit-bounces@debbugs.gnu.org Errors-To: debbugs-submit-bounces@debbugs.gnu.org X-Spam-Score: -2.6 (--) oOn Thu, Jul 5, 2012 at 2:52 AM, Stefan Monnier wrote: >> Whilst reading through the Emacs Lisp reference (specifically intro.texi), >> I did some copyediting, which resulted in the following patch series: > > Thank you, installed It would appear that I removed 2 commas that I should have left in place, as pointed out by Glenn Morris here: http://debbugs.gnu.org/cgi/bugreport.cgi?msg=40;bug=11862 Shall I update the 2 offending patches: http://debbugs.gnu.org/cgi/bugreport.cgi?msg=14;bug=11862 http://debbugs.gnu.org/cgi/bugreport.cgi?msg=17;bug=11862 or should I send a new patch on top of the previous series? Sorry for the trouble, Michael Witten From debbugs-submit-bounces@debbugs.gnu.org Thu Jul 05 03:14:07 2012 Received: (at 11862) by debbugs.gnu.org; 5 Jul 2012 07:14:07 +0000 Received: from localhost ([127.0.0.1]:49528 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1SmgGM-0004v3-IP for submit@debbugs.gnu.org; Thu, 05 Jul 2012 03:14:07 -0400 Received: from fencepost.gnu.org ([208.118.235.10]:53198) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1SmgGK-0004uv-Si for 11862@debbugs.gnu.org; Thu, 05 Jul 2012 03:14:05 -0400 Received: from rgm by fencepost.gnu.org with local (Exim 4.71) (envelope-from ) id 1SmgBb-0001dN-1h; Thu, 05 Jul 2012 03:09:11 -0400 From: Glenn Morris To: Michael Witten Subject: Re: bug#11862: [PATCH 0/9] doc/lispref/intro.texi: Copyediting References: X-Spook: plutonium underground Forte terrorist enforcers BLU-114/B X-Ran: *OmY(U%6E~2)w+*%Vou~1FxXNs$F^th{Ld6A9[DPkRAkJgYRPIy.RD}h9Z5Z(q(g[>|h5E X-Hue: red X-Debbugs-No-Ack: yes X-Attribution: GM Date: Thu, 05 Jul 2012 03:09:10 -0400 In-Reply-To: (Michael Witten's message of "Thu, 5 Jul 2012 04:36:27 +0000") Message-ID: User-Agent: Gnus (www.gnus.org), GNU Emacs (www.gnu.org/software/emacs/) MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Spam-Score: -6.9 (------) X-Debbugs-Envelope-To: 11862 Cc: 11862@debbugs.gnu.org X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.13 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Sender: debbugs-submit-bounces@debbugs.gnu.org Errors-To: debbugs-submit-bounces@debbugs.gnu.org X-Spam-Score: -6.9 (------) It's ok, I already installed a correction (I should have said). From debbugs-submit-bounces@debbugs.gnu.org Thu Jul 05 06:18:56 2012 Received: (at 11862) by debbugs.gnu.org; 5 Jul 2012 10:18:56 +0000 Received: from localhost ([127.0.0.1]:49779 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1Smj9A-0001Qr-R6 for submit@debbugs.gnu.org; Thu, 05 Jul 2012 06:18:55 -0400 Received: from fencepost.gnu.org ([208.118.235.10]:59202) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1Smj97-0001Qc-6O for 11862@debbugs.gnu.org; Thu, 05 Jul 2012 06:18:50 -0400 Received: from rms by fencepost.gnu.org with local (Exim 4.71) (envelope-from ) id 1Smj4N-0003RM-Ms; Thu, 05 Jul 2012 06:13:55 -0400 Date: Thu, 05 Jul 2012 06:13:55 -0400 Message-Id: Content-Type: text/plain; charset=ISO-8859-15 From: Richard Stallman To: Michael Witten In-reply-to: <49c61d76f8a84f2b8ac1091b557d0864-mfwitten@gmail.com> (message from Michael Witten on Wed, 04 Jul 2012 20:15:39 -0000) Subject: Re: bug#11862: [PATCH 1/9] doc/lispref/intro.texi: Offset modifier with a comma References: <49c61d76f8a84f2b8ac1091b557d0864-mfwitten@gmail.com> X-Spam-Score: -6.9 (------) X-Debbugs-Envelope-To: 11862 Cc: 11862@debbugs.gnu.org X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.13 Precedence: list Reply-To: rms@gnu.org List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Sender: debbugs-submit-bounces@debbugs.gnu.org Errors-To: debbugs-submit-bounces@debbugs.gnu.org X-Spam-Score: -6.9 (------) - Sometimes to help describe one form we show another form that + Sometimes to help describe one form, we show another form that produces identical results. An unpaired comma here is not correct. This would be correct + Sometimes, to help describe one form, we show another form that or this + To help describe one form, we sometimes show another form that However, the current text is also correct; commas here are not required. -- Dr Richard Stallman President, Free Software Foundation 51 Franklin St Boston MA 02110 USA www.fsf.org www.gnu.org Skype: No way! That's nonfree (freedom-denying) software. Use Ekiga or an ordinary phone call From debbugs-submit-bounces@debbugs.gnu.org Thu Jul 05 06:18:56 2012 Received: (at 11862) by debbugs.gnu.org; 5 Jul 2012 10:18:56 +0000 Received: from localhost ([127.0.0.1]:49782 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1Smj9E-0001RB-1l for submit@debbugs.gnu.org; Thu, 05 Jul 2012 06:18:56 -0400 Received: from fencepost.gnu.org ([208.118.235.10]:59204) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1Smj98-0001Qe-3x for 11862@debbugs.gnu.org; Thu, 05 Jul 2012 06:18:51 -0400 Received: from rms by fencepost.gnu.org with local (Exim 4.71) (envelope-from ) id 1Smj4O-0003Ra-SF; Thu, 05 Jul 2012 06:13:56 -0400 Date: Thu, 05 Jul 2012 06:13:56 -0400 Message-Id: Content-Type: text/plain; charset=ISO-8859-15 From: Richard Stallman To: Michael Witten In-reply-to: <5a8b591bcd694380a2bd8d47b36d037a-mfwitten@gmail.com> (message from Michael Witten on Wed, 04 Jul 2012 20:15:42 -0000) Subject: Re: bug#11862: [PATCH 2/9] doc/lispref/intro.texi: `can' -> `may' References: <5a8b591bcd694380a2bd8d47b36d037a-mfwitten@gmail.com> X-Spam-Score: -6.9 (------) X-Debbugs-Envelope-To: 11862 Cc: 11862@debbugs.gnu.org X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.13 Precedence: list Reply-To: rms@gnu.org List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Sender: debbugs-submit-bounces@debbugs.gnu.org Errors-To: debbugs-submit-bounces@debbugs.gnu.org X-Spam-Score: -6.9 (------) The keyword @code{&rest} (which must be followed by a single -argument name) indicates that any number of arguments can follow. The +argument name) indicates that any number of arguments may follow. The old text is correct. Replacing it with "may" is not wrong, but it adds a formality that we try to avoid in GNU manuals. So please don't make this change. -- Dr Richard Stallman President, Free Software Foundation 51 Franklin St Boston MA 02110 USA www.fsf.org www.gnu.org Skype: No way! That's nonfree (freedom-denying) software. Use Ekiga or an ordinary phone call From debbugs-submit-bounces@debbugs.gnu.org Thu Jul 05 06:18:57 2012 Received: (at 11862) by debbugs.gnu.org; 5 Jul 2012 10:18:57 +0000 Received: from localhost ([127.0.0.1]:49784 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1Smj9E-0001RH-F6 for submit@debbugs.gnu.org; Thu, 05 Jul 2012 06:18:56 -0400 Received: from fencepost.gnu.org ([208.118.235.10]:59206) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1Smj99-0001Qk-4D for 11862@debbugs.gnu.org; Thu, 05 Jul 2012 06:18:53 -0400 Received: from rms by fencepost.gnu.org with local (Exim 4.71) (envelope-from ) id 1Smj4P-0003Rh-Tq; Thu, 05 Jul 2012 06:13:57 -0400 Date: Thu, 05 Jul 2012 06:13:57 -0400 Message-Id: Content-Type: text/plain; charset=ISO-8859-15 From: Richard Stallman To: Michael Witten In-reply-to: (message from Michael Witten on Wed, 04 Jul 2012 20:15:45 -0000) Subject: Re: bug#11862: [PATCH 3/9] doc/lispref/intro.texi: Eradicate that pesky future tense References: X-Spam-Score: -6.9 (------) X-Debbugs-Envelope-To: 11862 Cc: 11862@debbugs.gnu.org X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.13 Precedence: list Reply-To: rms@gnu.org List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Sender: debbugs-submit-bounces@debbugs.gnu.org Errors-To: debbugs-submit-bounces@debbugs.gnu.org X-Spam-Score: -6.9 (------) Universal and eternal truths are better represented with the present tense. That's right. -- Dr Richard Stallman President, Free Software Foundation 51 Franklin St Boston MA 02110 USA www.fsf.org www.gnu.org Skype: No way! That's nonfree (freedom-denying) software. Use Ekiga or an ordinary phone call From debbugs-submit-bounces@debbugs.gnu.org Thu Jul 05 06:18:57 2012 Received: (at 11862) by debbugs.gnu.org; 5 Jul 2012 10:18:57 +0000 Received: from localhost ([127.0.0.1]:49786 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1Smj9F-0001RO-6C for submit@debbugs.gnu.org; Thu, 05 Jul 2012 06:18:57 -0400 Received: from fencepost.gnu.org ([208.118.235.10]:59214) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1Smj9A-0001Qp-5X for 11862@debbugs.gnu.org; Thu, 05 Jul 2012 06:18:53 -0400 Received: from rms by fencepost.gnu.org with local (Exim 4.71) (envelope-from ) id 1Smj4Q-0003Ro-Vv; Thu, 05 Jul 2012 06:13:59 -0400 Date: Thu, 05 Jul 2012 06:13:58 -0400 Message-Id: Content-Type: text/plain; charset=ISO-8859-15 From: Richard Stallman To: Michael Witten In-reply-to: <5d871479d57e4d94a538f7f27be2c620-mfwitten@gmail.com> (message from Michael Witten on Wed, 04 Jul 2012 20:15:48 -0000) Subject: Re: bug#11862: [PATCH 4/9] doc/lispref/intro.texi: More precise language References: <5d871479d57e4d94a538f7f27be2c620-mfwitten@gmail.com> X-Spam-Score: -6.9 (------) X-Debbugs-Envelope-To: 11862 Cc: 11862@debbugs.gnu.org X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.13 Precedence: list Reply-To: rms@gnu.org List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Sender: debbugs-submit-bounces@debbugs.gnu.org Errors-To: debbugs-submit-bounces@debbugs.gnu.org X-Spam-Score: -6.9 (------) Any argument whose name contains the name of a type (e.g., -@var{integer}, @var{integer1} or @var{buffer}) is expected to be of that +@var{integer}, @var{integer1} or @var{buffer}) is expected to be +bound to an object of that type. We normally use "argument" to refer to the value, not the name. Thus, it is correct as written now. Please don't make it more pedantic. -- Dr Richard Stallman President, Free Software Foundation 51 Franklin St Boston MA 02110 USA www.fsf.org www.gnu.org Skype: No way! That's nonfree (freedom-denying) software. Use Ekiga or an ordinary phone call From debbugs-submit-bounces@debbugs.gnu.org Thu Jul 05 06:18:58 2012 Received: (at 11862) by debbugs.gnu.org; 5 Jul 2012 10:18:58 +0000 Received: from localhost ([127.0.0.1]:49788 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1Smj9F-0001RV-QD for submit@debbugs.gnu.org; Thu, 05 Jul 2012 06:18:58 -0400 Received: from fencepost.gnu.org ([208.118.235.10]:59216) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1Smj9B-0001Qy-AO for 11862@debbugs.gnu.org; Thu, 05 Jul 2012 06:18:54 -0400 Received: from rms by fencepost.gnu.org with local (Exim 4.71) (envelope-from ) id 1Smj4S-0003S6-1Q; Thu, 05 Jul 2012 06:14:00 -0400 Date: Thu, 05 Jul 2012 06:14:00 -0400 Message-Id: Content-Type: text/plain; charset=ISO-8859-15 From: Richard Stallman To: Michael Witten In-reply-to: <51e3eb5ff6ec469b84839dcede4eb072-mfwitten@gmail.com> (message from Michael Witten on Wed, 04 Jul 2012 20:16:07 -0000) Subject: Re: bug#11862: [PATCH 9/9] doc/lispref/intro.texi: Use passive voice References: <51e3eb5ff6ec469b84839dcede4eb072-mfwitten@gmail.com> X-Spam-Score: -6.9 (------) X-Debbugs-Envelope-To: 11862 Cc: 11862@debbugs.gnu.org X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.13 Precedence: list Reply-To: rms@gnu.org List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Sender: debbugs-submit-bounces@debbugs.gnu.org Errors-To: debbugs-submit-bounces@debbugs.gnu.org X-Spam-Score: -6.9 (------) The value of this variable is the version of Emacs being run. It is a string such as @code{"23.1.1"}. The last number in this string is not really part of the Emacs release version number; it is incremented -each time you build Emacs in any given directory. A value with four +each time Emacs is built in any given directory. Please use the active voice by preference. For instance, you could write it this: each time you build Emacs in a given directory, that increments this number. -- Dr Richard Stallman President, Free Software Foundation 51 Franklin St Boston MA 02110 USA www.fsf.org www.gnu.org Skype: No way! That's nonfree (freedom-denying) software. Use Ekiga or an ordinary phone call From debbugs-submit-bounces@debbugs.gnu.org Thu Jul 05 10:09:15 2012 Received: (at 11862) by debbugs.gnu.org; 5 Jul 2012 14:09:15 +0000 Received: from localhost ([127.0.0.1]:50470 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1Smmk7-0007Wn-A2 for submit@debbugs.gnu.org; Thu, 05 Jul 2012 10:09:15 -0400 Received: from mailout-de.gmx.net ([213.165.64.23]:55442) by debbugs.gnu.org with smtp (Exim 4.72) (envelope-from ) id 1Smmk5-0007Wf-6j for 11862@debbugs.gnu.org; Thu, 05 Jul 2012 10:09:14 -0400 Received: (qmail invoked by alias); 05 Jul 2012 14:04:19 -0000 Received: from i59F5797E.versanet.de (EHLO nolde.home) [89.245.121.126] by mail.gmx.net (mp041) with SMTP; 05 Jul 2012 16:04:19 +0200 X-Authenticated: #20778731 X-Provags-ID: V01U2FsdGVkX18zUQsJXjIzpQPKj+bkZ828xdJ63sIdGxNk7+LkUx 5dsbzHbJ/dWNV1 From: Stephen Berman To: rms@gnu.org Subject: Re: bug#11862: [PATCH 9/9] doc/lispref/intro.texi: Use passive voice References: <51e3eb5ff6ec469b84839dcede4eb072-mfwitten@gmail.com> Date: Thu, 05 Jul 2012 16:04:22 +0200 In-Reply-To: (Richard Stallman's message of "Thu, 05 Jul 2012 06:14:00 -0400") Message-ID: <87bojuxq1l.fsf@nolde.home> User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/24.1 (gnu/linux) MIME-Version: 1.0 Content-Type: text/plain X-Y-GMX-Trusted: 0 X-Spam-Score: -1.9 (-) X-Debbugs-Envelope-To: 11862 Cc: 11862@debbugs.gnu.org, Michael Witten X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.13 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Sender: debbugs-submit-bounces@debbugs.gnu.org Errors-To: debbugs-submit-bounces@debbugs.gnu.org X-Spam-Score: -1.9 (-) On Thu, 05 Jul 2012 06:14:00 -0400 Richard Stallman wrote: > The value of this variable is the version of Emacs being run. It is a > string such as @code{"23.1.1"}. The last number in this string is not > really part of the Emacs release version number; it is incremented > -each time you build Emacs in any given directory. A value with four > +each time Emacs is built in any given directory. > > Please use the active voice by preference. > For instance, you could write it this: > > each time you build Emacs in a given directory, that increments this number. This sounds rather awkward to me. Would you accept "it gets incremented" as a "more active passive" alternative? Aside from style, the statement is inaccurate, isn't it? At least with "make bootstrap" the last number is always 1. Steve Berman From debbugs-submit-bounces@debbugs.gnu.org Thu Jul 05 12:42:58 2012 Received: (at 11862) by debbugs.gnu.org; 5 Jul 2012 16:42:58 +0000 Received: from localhost ([127.0.0.1]:50813 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1Smp8n-0003Qr-18 for submit@debbugs.gnu.org; Thu, 05 Jul 2012 12:42:56 -0400 Received: from mtaout22.012.net.il ([80.179.55.172]:37275) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1Smp8g-0003Qe-N0 for 11862@debbugs.gnu.org; Thu, 05 Jul 2012 12:42:47 -0400 Received: from conversion-daemon.a-mtaout22.012.net.il by a-mtaout22.012.net.il (HyperSendmail v2007.08) id <0M6P008004QOMY00@a-mtaout22.012.net.il> for 11862@debbugs.gnu.org; Thu, 05 Jul 2012 19:37:52 +0300 (IDT) Received: from HOME-C4E4A596F7 ([87.69.210.75]) by a-mtaout22.012.net.il (HyperSendmail v2007.08) with ESMTPA id <0M6P008DD4V4KT20@a-mtaout22.012.net.il>; Thu, 05 Jul 2012 19:37:52 +0300 (IDT) Date: Thu, 05 Jul 2012 19:37:55 +0300 From: Eli Zaretskii Subject: Re: bug#11862: [PATCH 9/9] doc/lispref/intro.texi: Use passive voice In-reply-to: <87bojuxq1l.fsf@nolde.home> X-012-Sender: halo1@inter.net.il To: Stephen Berman Message-id: <83txxm2mfw.fsf@gnu.org> References: <51e3eb5ff6ec469b84839dcede4eb072-mfwitten@gmail.com> <87bojuxq1l.fsf@nolde.home> X-Spam-Score: -1.2 (-) X-Debbugs-Envelope-To: 11862 Cc: 11862@debbugs.gnu.org, rms@gnu.org X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.13 Precedence: list Reply-To: Eli Zaretskii List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Sender: debbugs-submit-bounces@debbugs.gnu.org Errors-To: debbugs-submit-bounces@debbugs.gnu.org X-Spam-Score: -1.2 (-) > From: Stephen Berman > Date: Thu, 05 Jul 2012 16:04:22 +0200 > Cc: 11862@debbugs.gnu.org > > On Thu, 05 Jul 2012 06:14:00 -0400 Richard Stallman wrote: > > > The value of this variable is the version of Emacs being run. It is a > > string such as @code{"23.1.1"}. The last number in this string is not > > really part of the Emacs release version number; it is incremented > > -each time you build Emacs in any given directory. A value with four > > +each time Emacs is built in any given directory. > > > > Please use the active voice by preference. > > For instance, you could write it this: > > > > each time you build Emacs in a given directory, that increments this number. > > This sounds rather awkward to me. Would you accept "it gets > incremented" as a "more active passive" alternative? I think there's a better alternative that is entirely active: each build of Emacs in any given directory increments that number. > Aside from style, the statement is inaccurate, isn't it? At least > with "make bootstrap" the last number is always 1. Yes. So: The value of this variable is the version of Emacs being run. It is a string such as @code{"23.1.1"}. The last number in this string is not really part of the Emacs release version number; it starts at 1, is reset to 1 by @kbd{make bootstrap}, and each build of Emacs increments that number. From debbugs-submit-bounces@debbugs.gnu.org Thu Jul 05 12:58:14 2012 Received: (at 11862) by debbugs.gnu.org; 5 Jul 2012 16:58:14 +0000 Received: from localhost ([127.0.0.1]:50835 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1SmpNd-0003nd-PE for submit@debbugs.gnu.org; Thu, 05 Jul 2012 12:58:13 -0400 Received: from mail-bk0-f44.google.com ([209.85.214.44]:65124) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1SmpNc-0003nW-FT for 11862@debbugs.gnu.org; Thu, 05 Jul 2012 12:58:13 -0400 Received: by bkty7 with SMTP id y7so569247bkt.3 for <11862@debbugs.gnu.org>; Thu, 05 Jul 2012 09:53:17 -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=EyhuFa6u7X5wQeh6ZMTxX4aULoePof9EZTl0hfHql7g=; b=ucUUhQPF63QjRiOp79cEf6yIwc2ajP3f0mDQccoiIlHnk+kN4v7rWYfIMqLMV2bJtn FTAhb6eQSKxiROTz7qXorbuR0ZoRHvqQubz6PQ6HsOUI+4YRCimAIuEIVFbDD0p7H4Nr kQ2RtohwO5mieesCN7DzbIuDg6gsKQ6lTQR1P5XoPPRhTGvAXD6uBYaIuanwQU/T//tY n4nBdLRph/zQPbFDk3Ym400b2Pcsluyctct5M8XBvHKEwTgyklqFAUACokxPQK/01I83 yu+BT1Sx7gdm6Oq86Omczl7tOB3fRWweJnFbe5Y8QRLM0o3HC4XhmGlXFaV33t+CUZFf 4mkQ== Received: by 10.204.136.215 with SMTP id s23mr13880473bkt.32.1341507197439; Thu, 05 Jul 2012 09:53:17 -0700 (PDT) Received: from gmail.com (tor18.anonymizer.ccc.de. [31.172.30.1]) by mx.google.com with ESMTPS id o4sm20933019bkv.15.2012.07.05.09.53.15 (version=TLSv1/SSLv3 cipher=OTHER); Thu, 05 Jul 2012 09:53:16 -0700 (PDT) Subject: Re: bug#11862: [PATCH 1/9] doc/lispref/intro.texi: Offset modifier Date: Thu, 05 Jul 2012 16:52:00 -0000 From: Michael Witten To: Richard Stallman Message-ID: In-Reply-To: References: <49c61d76f8a84f2b8ac1091b557d0864-mfwitten@gmail.com> X-Spam-Score: -2.6 (--) X-Debbugs-Envelope-To: 11862 Cc: 11862@debbugs.gnu.org X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.13 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Sender: debbugs-submit-bounces@debbugs.gnu.org Errors-To: debbugs-submit-bounces@debbugs.gnu.org X-Spam-Score: -2.6 (--) On Thu, 05 Jul 2012 06:13:55 -0400, Richard Stallman wrote: > - Sometimes to help describe one form we show another form that > + Sometimes to help describe one form, we show another form that > produces identical results. > > An unpaired comma here is not correct. > This would be correct > > + Sometimes, to help describe one form, we show another form that > > or this > > + To help describe one form, we sometimes show another form that > > However, the current text is also correct; commas here are not > required. I prefer your second suggestion above all else. From debbugs-submit-bounces@debbugs.gnu.org Thu Jul 05 13:04:48 2012 Received: (at 11862) by debbugs.gnu.org; 5 Jul 2012 17:04:48 +0000 Received: from localhost ([127.0.0.1]:50849 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1SmpU0-0004mz-6T for submit@debbugs.gnu.org; Thu, 05 Jul 2012 13:04:48 -0400 Received: from fencepost.gnu.org ([208.118.235.10]:38641) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1SmpTy-0004ms-9E for 11862@debbugs.gnu.org; Thu, 05 Jul 2012 13:04:46 -0400 Received: from rgm by fencepost.gnu.org with local (Exim 4.71) (envelope-from ) id 1SmpPC-0001n9-Lt; Thu, 05 Jul 2012 12:59:50 -0400 From: Glenn Morris To: Eli Zaretskii Subject: Re: bug#11862: [PATCH 9/9] doc/lispref/intro.texi: Use passive voice References: <51e3eb5ff6ec469b84839dcede4eb072-mfwitten@gmail.com> <87bojuxq1l.fsf@nolde.home> <83txxm2mfw.fsf@gnu.org> X-Spook: militia John Kerry counter intelligence Ron Brown tempest X-Ran: E`K(3cI?`Al_npd|gLV|?^qQ[V'a_XaN4\PT}{ X-Hue: green X-Debbugs-No-Ack: yes X-Attribution: GM Date: Thu, 05 Jul 2012 12:59:50 -0400 In-Reply-To: <83txxm2mfw.fsf@gnu.org> (Eli Zaretskii's message of "Thu, 05 Jul 2012 19:37:55 +0300") Message-ID: User-Agent: Gnus (www.gnus.org), GNU Emacs (www.gnu.org/software/emacs/) MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Spam-Score: -6.9 (------) X-Debbugs-Envelope-To: 11862 Cc: 11862@debbugs.gnu.org, Stephen Berman , rms@gnu.org X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.13 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Sender: debbugs-submit-bounces@debbugs.gnu.org Errors-To: debbugs-submit-bounces@debbugs.gnu.org X-Spam-Score: -6.9 (------) >> Aside from style, the statement is inaccurate, isn't it? At least >> with "make bootstrap" the last number is always 1. I don't think the lispref needs to worry about these details. (Plain `make clean' causes the same result; it seems kind of obvious to me...). From debbugs-submit-bounces@debbugs.gnu.org Thu Jul 05 13:19:41 2012 Received: (at 11862) by debbugs.gnu.org; 5 Jul 2012 17:19:41 +0000 Received: from localhost ([127.0.0.1]:50873 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1SmpiP-0005xU-JG for submit@debbugs.gnu.org; Thu, 05 Jul 2012 13:19:41 -0400 Received: from mail-qa0-f44.google.com ([209.85.216.44]:47092) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1SmpiN-0005xM-Lu for 11862@debbugs.gnu.org; Thu, 05 Jul 2012 13:19:40 -0400 Received: by qadz3 with SMTP id z3so4333060qad.3 for <11862@debbugs.gnu.org>; Thu, 05 Jul 2012 10:14:45 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20120113; h=mime-version:in-reply-to:references:from:date:message-id:subject:to :cc:content-type; bh=HKMkFLUKwn9Tvsr/gBurqdSMDF/Pky8MNX6VgQj+NfI=; b=IZiSvIIBr1JdjNkS3v+cDQiFgS7LJ4nfaMEsPcGUCMskmCtzYmYJ/mEeI1vLaxTi5S /qCtLuNEy3cDzKSk/7MzNuqm1A4MuD9JKjpRZj4n59lbDUKFNG6Ybm9lQUIueM0Q350F gAlOcRdzf53YygkHW6K3tNzDi2HAYLtaCnN/LUEvjzqAPmM0QWmJJDHgHXU/Ph908OBp CFthjn+4tOadd2rfdPtJLcKhhxPvY06swzlIVBoqodTciqtwONxk5gmeUwDK5ZBlcEG/ 6lhFir2HXJrwoFc9nNrkY8mxJBvI69gsRfwyWxTBc6BanM1tpTBo9cy7T2flco3Yx67c iTVg== Received: by 10.224.9.70 with SMTP id k6mr1202658qak.31.1341508485866; Thu, 05 Jul 2012 10:14:45 -0700 (PDT) MIME-Version: 1.0 Received: by 10.229.241.1 with HTTP; Thu, 5 Jul 2012 10:14:15 -0700 (PDT) In-Reply-To: <83txxm2mfw.fsf@gnu.org> References: <51e3eb5ff6ec469b84839dcede4eb072-mfwitten@gmail.com> <87bojuxq1l.fsf@nolde.home> <83txxm2mfw.fsf@gnu.org> From: Michael Witten Date: Thu, 5 Jul 2012 17:14:15 +0000 Message-ID: Subject: Re: bug#11862: [PATCH 9/9] doc/lispref/intro.texi: Use passive voice To: Eli Zaretskii Content-Type: text/plain; charset=UTF-8 X-Spam-Score: -2.6 (--) X-Debbugs-Envelope-To: 11862 Cc: Glenn Morris , Stephen Berman , Richard Stallman , 11862@debbugs.gnu.org X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.13 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Sender: debbugs-submit-bounces@debbugs.gnu.org Errors-To: debbugs-submit-bounces@debbugs.gnu.org X-Spam-Score: -2.6 (--) On Thu, 05 Jul 2012 19:37:55 +0300, Eli Zaretskii wrote: > it starts at 1, is reset to 1 by @kbd{make bootstrap}, and each build > of Emacs increments that number. In all clauses but the last, `it' (that is, the last number) is the subject. Moroever, the middle clause is already in the passive voice. So, for the sake of consistency, why not continue with both the subject `it' and that passive voice: it starts at 1, is reset to 1 by @kbd{make bootstrap}, and is incremented each time Emacs is built. Perhaps this is a better order: it starts at 1, is incremented each time Emacs is built, and is reset to 1 by @kbd{make bootstrap}. Of course, as Glenn Morris points out, the way in which `it' is reset is not of great importance. So, how about: it starts at 1, is incremented each time Emacs is built, and can be reset by something like @kbd{make clean} or @kbd{make bootstrap}. From debbugs-submit-bounces@debbugs.gnu.org Thu Jul 05 15:14:09 2012 Received: (at 11862) by debbugs.gnu.org; 5 Jul 2012 19:14:09 +0000 Received: from localhost ([127.0.0.1]:50961 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1SmrVB-0000sR-5y for submit@debbugs.gnu.org; Thu, 05 Jul 2012 15:14:09 -0400 Received: from mailout-de.gmx.net ([213.165.64.22]:55315) by debbugs.gnu.org with smtp (Exim 4.72) (envelope-from ) id 1SmrV8-0000sK-At for 11862@debbugs.gnu.org; Thu, 05 Jul 2012 15:14:07 -0400 Received: (qmail invoked by alias); 05 Jul 2012 19:09:10 -0000 Received: from i59F5797E.versanet.de (EHLO nolde.home) [89.245.121.126] by mail.gmx.net (mp036) with SMTP; 05 Jul 2012 21:09:10 +0200 X-Authenticated: #20778731 X-Provags-ID: V01U2FsdGVkX18FzVpGrSoFPeC/Mc8FTtbKNtnFjL4fcwWiWONpNw UnTuRdpp1s30js From: Stephen Berman To: Michael Witten Subject: Re: bug#11862: [PATCH 9/9] doc/lispref/intro.texi: Use passive voice References: <51e3eb5ff6ec469b84839dcede4eb072-mfwitten@gmail.com> <87bojuxq1l.fsf@nolde.home> <83txxm2mfw.fsf@gnu.org> Date: Thu, 05 Jul 2012 21:09:12 +0200 In-Reply-To: (Michael Witten's message of "Thu, 5 Jul 2012 17:14:15 +0000") Message-ID: <87obnut487.fsf@nolde.home> User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/24.1 (gnu/linux) MIME-Version: 1.0 Content-Type: text/plain X-Y-GMX-Trusted: 0 X-Spam-Score: -1.9 (-) X-Debbugs-Envelope-To: 11862 Cc: 11862@debbugs.gnu.org, Eli Zaretskii , Richard Stallman X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.13 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Sender: debbugs-submit-bounces@debbugs.gnu.org Errors-To: debbugs-submit-bounces@debbugs.gnu.org X-Spam-Score: -1.9 (-) On Thu, 5 Jul 2012 17:14:15 +0000 Michael Witten wrote: > On Thu, 05 Jul 2012 19:37:55 +0300, Eli Zaretskii wrote: > >> it starts at 1, is reset to 1 by @kbd{make bootstrap}, and each build >> of Emacs increments that number. > > In all clauses but the last, `it' (that is, the last number) is the subject. > Moroever, the middle clause is already in the passive voice. So, for the sake of > consistency, why not continue with both the subject `it' and that passive voice: > > it starts at 1, is reset to 1 by @kbd{make bootstrap}, and is incremented each > time Emacs is built. > > Perhaps this is a better order: > > it starts at 1, is incremented each time Emacs is built, and is reset to 1 by > @kbd{make bootstrap}. > > Of course, as Glenn Morris points out, the way in which `it' is reset is not of > great importance. So, how about: > > it starts at 1, is incremented each time Emacs is built, and can be reset by > something like @kbd{make clean} or @kbd{make bootstrap}. Here's another attempt to satisfy the no passive preference: The last number in this string is not part of the Emacs release version number, but is a counter representing the build number; each time you rebuild Emacs, the last number increases by one (but building with @kbd{make clean} or @kbd{make bootstrap} resets it to 1). Steve Berman From debbugs-submit-bounces@debbugs.gnu.org Thu Jul 05 17:55:42 2012 Received: (at 11862) by debbugs.gnu.org; 5 Jul 2012 21:55:42 +0000 Received: from localhost ([127.0.0.1]:51091 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1Smu1V-0006A8-VZ for submit@debbugs.gnu.org; Thu, 05 Jul 2012 17:55:42 -0400 Received: from fencepost.gnu.org ([208.118.235.10]:42511) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1Smu1T-0006A1-Mj for 11862@debbugs.gnu.org; Thu, 05 Jul 2012 17:55:40 -0400 Received: from rms by fencepost.gnu.org with local (Exim 4.71) (envelope-from ) id 1Smtwh-0001iP-Ff; Thu, 05 Jul 2012 17:50:43 -0400 Date: Thu, 05 Jul 2012 17:50:43 -0400 Message-Id: Content-Type: text/plain; charset=ISO-8859-15 From: Richard Stallman To: Michael Witten In-reply-to: <22f1c29cd7e44a3e91ca67e534dc03a4-mfwitten@gmail.com> (message from Michael Witten on Wed, 04 Jul 2012 20:15:59 -0000) Subject: Re: bug#11862: [PATCH 8/9] doc/lispref/intro.texi: More precise language for References: <22f1c29cd7e44a3e91ca67e534dc03a4-mfwitten@gmail.com> X-Spam-Score: -6.9 (------) X-Debbugs-Envelope-To: 11862 Cc: 11862@debbugs.gnu.org X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.13 Precedence: list Reply-To: rms@gnu.org List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Sender: debbugs-submit-bounces@debbugs.gnu.org Errors-To: debbugs-submit-bounces@debbugs.gnu.org X-Spam-Score: -6.9 (------) + 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. -- Dr Richard Stallman President, Free Software Foundation 51 Franklin St Boston MA 02110 USA www.fsf.org www.gnu.org Skype: No way! That's nonfree (freedom-denying) software. Use Ekiga or an ordinary phone call From debbugs-submit-bounces@debbugs.gnu.org Thu Jul 05 19:15:05 2012 Received: (at 11862) by debbugs.gnu.org; 5 Jul 2012 23:15:05 +0000 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 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 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== Received: by 10.112.46.101 with SMTP id u5mr12673620lbm.21.1341529806282; Thu, 05 Jul 2012 16:10:06 -0700 (PDT) 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) Subject: [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 From: Michael Witten To: Richard Stallman Message-ID: <3c1c3c1cfe3840e19551bfd0424eb99d-mfwitten@gmail.com> In-Reply-To: References: <22f1c29cd7e44a3e91ca67e534dc03a4-mfwitten@gmail.com> X-Spam-Score: -2.6 (--) X-Debbugs-Envelope-To: 11862 Cc: 11862@debbugs.gnu.org X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.13 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Sender: debbugs-submit-bounces@debbugs.gnu.org Errors-To: debbugs-submit-bounces@debbugs.gnu.org X-Spam-Score: -2.6 (--) 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 From debbugs-submit-bounces@debbugs.gnu.org Thu Jul 05 22:03:19 2012 Received: (at 11862) by debbugs.gnu.org; 6 Jul 2012 02:03:19 +0000 Received: from localhost ([127.0.0.1]:51170 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1Smxt7-00040X-Qe for submit@debbugs.gnu.org; Thu, 05 Jul 2012 22:03:19 -0400 Received: from acsinet15.oracle.com ([141.146.126.227]:20997) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1Smxt5-00040Q-AZ for 11862@debbugs.gnu.org; Thu, 05 Jul 2012 22:03:16 -0400 Received: from ucsinet21.oracle.com (ucsinet21.oracle.com [156.151.31.93]) by acsinet15.oracle.com (Sentrion-MTA-4.2.2/Sentrion-MTA-4.2.2) with ESMTP id q661wHoH021383 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=OK); Fri, 6 Jul 2012 01:58:18 GMT Received: from acsmt357.oracle.com (acsmt357.oracle.com [141.146.40.157]) by ucsinet21.oracle.com (8.14.4+Sun/8.14.4) with ESMTP id q661wGSA021082 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=NO); Fri, 6 Jul 2012 01:58:16 GMT Received: from abhmt109.oracle.com (abhmt109.oracle.com [141.146.116.61]) by acsmt357.oracle.com (8.12.11.20060308/8.12.11) with ESMTP id q661wF7A030793; Thu, 5 Jul 2012 20:58:15 -0500 Received: from dradamslap1 (/10.159.161.157) by default (Oracle Beehive Gateway v4.0) with ESMTP ; Thu, 05 Jul 2012 18:58:15 -0700 From: "Drew Adams" To: "'Michael Witten'" , "'Richard Stallman'" References: <22f1c29cd7e44a3e91ca67e534dc03a4-mfwitten@gmail.com> <3c1c3c1cfe3840e19551bfd0424eb99d-mfwitten@gmail.com> Subject: RE: bug#11862: [PATCH 8/9 v2] doc/lispref/intro.texi: More preciselanguage for what a variable is Date: Thu, 5 Jul 2012 18:58:12 -0700 Message-ID: MIME-Version: 1.0 Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: 7bit X-Mailer: Microsoft Office Outlook 11 In-Reply-To: <3c1c3c1cfe3840e19551bfd0424eb99d-mfwitten@gmail.com> Thread-Index: Ac1bA3pjHPbJLdASSpWNm19G8rbUwQAFvS4w X-MimeOLE: Produced By Microsoft MimeOLE V6.00.2900.6157 X-Source-IP: ucsinet21.oracle.com [156.151.31.93] X-Spam-Score: -6.9 (------) X-Debbugs-Envelope-To: 11862 Cc: 11862@debbugs.gnu.org X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.13 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Sender: debbugs-submit-bounces@debbugs.gnu.org Errors-To: debbugs-submit-bounces@debbugs.gnu.org X-Spam-Score: -6.9 (------) > - 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. FWIW, to me, a Lisp variable is not just a "name" that can be bound or set... It is a Lisp symbol that is bound or set... From debbugs-submit-bounces@debbugs.gnu.org Fri Jul 06 02:45:42 2012 Received: (at 11862) by debbugs.gnu.org; 6 Jul 2012 06:45:42 +0000 Received: from localhost ([127.0.0.1]:51351 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1Sn2IP-0002Ph-4l for submit@debbugs.gnu.org; Fri, 06 Jul 2012 02:45:41 -0400 Received: from mtaout23.012.net.il ([80.179.55.175]:58590) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1Sn2IH-0002Iv-Su for 11862@debbugs.gnu.org; Fri, 06 Jul 2012 02:45:35 -0400 Received: from conversion-daemon.a-mtaout23.012.net.il by a-mtaout23.012.net.il (HyperSendmail v2007.08) id <0M6Q004007UDA600@a-mtaout23.012.net.il> for 11862@debbugs.gnu.org; Fri, 06 Jul 2012 09:40:35 +0300 (IDT) Received: from HOME-C4E4A596F7 ([87.69.210.75]) by a-mtaout23.012.net.il (HyperSendmail v2007.08) with ESMTPA id <0M6Q0043J7VN1090@a-mtaout23.012.net.il>; Fri, 06 Jul 2012 09:40:35 +0300 (IDT) Date: Fri, 06 Jul 2012 09:40:39 +0300 From: Eli Zaretskii Subject: Re: bug#11862: [PATCH 8/9 v2] doc/lispref/intro.texi: More precise language for what a variable is In-reply-to: <3c1c3c1cfe3840e19551bfd0424eb99d-mfwitten@gmail.com> X-012-Sender: halo1@inter.net.il To: Michael Witten Message-id: <83mx3d2xzs.fsf@gnu.org> References: <22f1c29cd7e44a3e91ca67e534dc03a4-mfwitten@gmail.com> <3c1c3c1cfe3840e19551bfd0424eb99d-mfwitten@gmail.com> X-Spam-Score: -1.2 (-) X-Debbugs-Envelope-To: 11862 Cc: 11862@debbugs.gnu.org, rms@gnu.org X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.13 Precedence: list Reply-To: Eli Zaretskii List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Sender: debbugs-submit-bounces@debbugs.gnu.org Errors-To: debbugs-submit-bounces@debbugs.gnu.org X-Spam-Score: -1.2 (-) > Date: Thu, 05 Jul 2012 22:55:46 -0000 > From: Michael Witten > Cc: 11862@debbugs.gnu.org > > + 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. "Holds" is not a term, so it should be devoid of any markup (and not in quotes, either). From debbugs-submit-bounces@debbugs.gnu.org Fri Jul 06 04:13:26 2012 Received: (at 11862) by debbugs.gnu.org; 6 Jul 2012 08:13:26 +0000 Received: from localhost ([127.0.0.1]:51390 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1Sn3fK-0004fm-3z for submit@debbugs.gnu.org; Fri, 06 Jul 2012 04:13:26 -0400 Received: from mail-wg0-f46.google.com ([74.125.82.46]:53786) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1Sn3fG-0004fe-F4 for 11862@debbugs.gnu.org; Fri, 06 Jul 2012 04:13:24 -0400 Received: by wgbdq10 with SMTP id dq10so8629515wgb.15 for <11862@debbugs.gnu.org>; Fri, 06 Jul 2012 01:08:24 -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=QHqWgRyUl9rh9BcTYcJbX466Azci9Nv+LxJINOGsHwk=; b=VXqWqKZN8RZIimpQLvuSh4ZcoFfGSbD1Syrk+6vccotztK1ynNQasnRNZZqV9n+HLt o73DyZBxKgu4eSB33UIOvAhKEKUiqhQNf/0t+ITme5oJ3CCUbkI/rWZccYTsHmXoSM34 9W+lCDiLMScCeqZD/wsqNf5Kpd5isskwV1EdXtGQ5Sd7VfX2vIW+w6SqRiwGVLjaBZgQ Ptq6/J0+eZGZHDUnhLYXNneeRB9YrBLOw5HpQhUCBSY7l/ZuGNDoQFlG9FafnQNk6GK/ EB6tiGTbTlUHOYrSziw4yU/2qZGNBpTTAoKLYAgDlksAt6AUIUSHHJk6vX748eUjlAmR pccQ== Received: by 10.180.20.239 with SMTP id q15mr5633019wie.13.1341562104473; Fri, 06 Jul 2012 01:08:24 -0700 (PDT) Received: from gmail.com ([95.211.153.115]) by mx.google.com with ESMTPS id h9sm4500036wiz.1.2012.07.06.01.08.21 (version=TLSv1/SSLv3 cipher=OTHER); Fri, 06 Jul 2012 01:08:23 -0700 (PDT) Subject: [PATCH 8/9 v3] doc/lispref/intro.texi: More precise language for what a variable is Date: Fri, 06 Jul 2012 08:07:31 -0000 From: Michael Witten To: Drew Adams Message-ID: <0c2cb6909a904ffeb3010bf4ca2e40b2-mfwitten@gmail.com> In-Reply-To: References: <22f1c29cd7e44a3e91ca67e534dc03a4-mfwitten@gmail.com> <3c1c3c1cfe3840e19551bfd0424eb99d-mfwitten@gmail.com> X-Spam-Score: -2.6 (--) X-Debbugs-Envelope-To: 11862 Cc: 11862@debbugs.gnu.org, Richard Stallman X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.13 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Sender: debbugs-submit-bounces@debbugs.gnu.org Errors-To: debbugs-submit-bounces@debbugs.gnu.org X-Spam-Score: -2.6 (--) On Thu, 5 Jul 2012 18:58:12 -0700, Drew Adams wrote: >> - 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. > > FWIW, to me, a Lisp variable is not just a "name" that can be bound > or set... It is a Lisp symbol that is bound or set... 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 these terms with language that is more pedantic, and it reorganizes the text, so that they are introduced in [more] proper places, thereby reducing redundancy. In particular: * The term `value' is introduced in node `Some Terms'; that term is used pervasively, so it should be brought to the reader's attention early on. * Node `A sample Variable Description' is reduced and reorganized. - The description of `variable' is removed entirely; such a descriptin is better placed in the node `Variables'. Moreover, this change is consistent with the text of the sibling node, `A Sample Function Description', which does not give such a description for a function, instead leaving that complex topic to more appropriate nodes, such as `Functions'. - The term `user options' is moved to the bottom of this node. * The node `Variables' is updated with more pedantic language. - The new introductory text makes a bolder association between variables and symbols (making the statement that a variable *is* a symbol, rather than the weaker statement that a variable is merely represented by a symbol); this may be worth more consideration. - The term `@dfn{bound}' is introduced. There is another `@dfn{bound}' in `doc/lispref/functions.texi', though it may be simply viewed as a different, but related concept. - The terms `@dfn{setting}' and `@dfn{holds}' are introduced for the sake of pointing them out as common (if not official) lingo. --- doc/lispref/intro.texi | 26 ++++++++++++-------------- doc/lispref/variables.texi | 19 ++++++++++--------- 2 files changed, 22 insertions(+), 23 deletions(-) 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/variables.texi b/doc/lispref/variables.texi index affaff4..863fd07 100644 --- a/doc/lispref/variables.texi +++ b/doc/lispref/variables.texi @@ -6,15 +6,16 @@ @chapter Variables @cindex variable - A @dfn{variable} is a name used in a program to stand for a value. -In Lisp, each variable is represented by a Lisp symbol -(@pxref{Symbols}). The variable name is simply the symbol's name, and -the variable's value is stored in the symbol's value cell@footnote{To -be precise, under the default @dfn{dynamic binding} rules the value -cell always holds the variable's current value, but this is not the -case under @dfn{lexical binding} rules. @xref{Variable Scoping}, for -details.}. @xref{Symbol Components}. In Emacs Lisp, the use of a -symbol as a variable is independent of its use as a function name. + A @dfn{variable} is a symbol that is @dfn{bound} to an object +(@pxref{Symbols}); binding is frequently referred to as @dfn{setting}, +and the object to which a variable is set is often called a value +that the variable @dfn{holds}, in that the value is stored in the +symbol's value cell@footnote{To be precise, under the default +@dfn{dynamic binding} rules the value cell always holds the variable's +current value, but this is not the case under @dfn{lexical binding} +rules. @xref{Variable Scoping}, for details.}. @xref{Symbol Components}. +In Emacs Lisp, the use of a symbol as a variable is independent of its +use as a function name (@pxref{Function Names}). As previously noted in this manual, a Lisp program is represented primarily by Lisp objects, and only secondarily as text. The textual -- 1.7.11.1.29.gf71be5c From debbugs-submit-bounces@debbugs.gnu.org Fri Jul 06 12:35:45 2012 Received: (at 11862) by debbugs.gnu.org; 6 Jul 2012 16:35:45 +0000 Received: from localhost ([127.0.0.1]:53009 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1SnBVQ-0000vS-9E for submit@debbugs.gnu.org; Fri, 06 Jul 2012 12:35:44 -0400 Received: from mx18.lb01.inode.at ([62.99.145.20]:2301 helo=mx.inode.at) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1SnBVO-0000vL-SV for 11862@debbugs.gnu.org; Fri, 06 Jul 2012 12:35:43 -0400 Received: from [91.119.212.90] (port=12674 helo=iznogoud.viz) by smartmx-18.inode.at with esmtps (TLS1.0:DHE_RSA_AES_256_CBC_SHA1:32) (Exim 4.69) (envelope-from ) id 1SnBQZ-0007qb-4U; Fri, 06 Jul 2012 18:30:43 +0200 Received: from wolfgang by iznogoud.viz with local (Exim 4.77 (FreeBSD)) (envelope-from ) id 1SnBQW-0000Yk-KX; Fri, 06 Jul 2012 18:30:40 +0200 From: Wolfgang Jenkner To: Michael Witten Subject: Re: bug#11862: [PATCH 8/9 v3] doc/lispref/intro.texi: More precise language for what a variable is Date: Fri, 06 Jul 2012 17:55:55 +0200 References: <22f1c29cd7e44a3e91ca67e534dc03a4-mfwitten@gmail.com> <3c1c3c1cfe3840e19551bfd0424eb99d-mfwitten@gmail.com> <0c2cb6909a904ffeb3010bf4ca2e40b2-mfwitten@gmail.com> Message-ID: <85pq88c0nj.fsf@iznogoud.viz> User-Agent: Gnus/5.130006 (Ma Gnus v0.6) Emacs/24.1.50 (berkeley-unix) MIME-Version: 1.0 Content-Type: text/plain X-Spam-Score: -1.9 (-) X-Debbugs-Envelope-To: 11862 Cc: 11862@debbugs.gnu.org, Richard Stallman , Drew Adams X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.13 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Sender: debbugs-submit-bounces@debbugs.gnu.org Errors-To: debbugs-submit-bounces@debbugs.gnu.org X-Spam-Score: -1.9 (-) On Fri, Jul 06 2012, Michael Witten wrote: > +(@pxref{Symbols}); binding is frequently referred to as @dfn{setting}, This is a bit misleading, except when speaking of previously unbound symbols or when using "is set" as a stative perfect. Could you please give an example where binding a bound symbol is described as "setting" it? IMHO, this would be a documentation bug. Wolfgang From debbugs-submit-bounces@debbugs.gnu.org Fri Jul 06 12:50:28 2012 Received: (at 11862) by debbugs.gnu.org; 6 Jul 2012 16:50:28 +0000 Received: from localhost ([127.0.0.1]:53029 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1SnBjZ-0001Hb-C5 for submit@debbugs.gnu.org; Fri, 06 Jul 2012 12:50:25 -0400 Received: from rcsinet15.oracle.com ([148.87.113.117]:37972) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1SnBjW-0001HR-MI for 11862@debbugs.gnu.org; Fri, 06 Jul 2012 12:50:19 -0400 Received: from acsinet22.oracle.com (acsinet22.oracle.com [141.146.126.238]) by rcsinet15.oracle.com (Sentrion-MTA-4.2.2/Sentrion-MTA-4.2.2) with ESMTP id q66GjHr7016911 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=OK); Fri, 6 Jul 2012 16:45:18 GMT Received: from acsmt358.oracle.com (acsmt358.oracle.com [141.146.40.158]) by acsinet22.oracle.com (8.14.4+Sun/8.14.4) with ESMTP id q66GjHQ0016412 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=NO); Fri, 6 Jul 2012 16:45:17 GMT Received: from abhmt118.oracle.com (abhmt118.oracle.com [141.146.116.70]) by acsmt358.oracle.com (8.12.11.20060308/8.12.11) with ESMTP id q66GjGZ3024775; Fri, 6 Jul 2012 11:45:16 -0500 Received: from dradamslap1 (/10.159.161.157) by default (Oracle Beehive Gateway v4.0) with ESMTP ; Fri, 06 Jul 2012 09:45:16 -0700 From: "Drew Adams" To: "'Wolfgang Jenkner'" , "'Michael Witten'" References: <22f1c29cd7e44a3e91ca67e534dc03a4-mfwitten@gmail.com><3c1c3c1cfe3840e19551bfd0424eb99d-mfwitten@gmail.com><0c2cb6909a904ffeb3010bf4ca2e40b2-mfwitten@gmail.com> <85pq88c0nj.fsf@iznogoud.viz> Subject: RE: bug#11862: [PATCH 8/9 v3] doc/lispref/intro.texi: More precise language for what a variable is Date: Fri, 6 Jul 2012 09:45:11 -0700 Message-ID: MIME-Version: 1.0 Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: 7bit X-Mailer: Microsoft Office Outlook 11 In-Reply-To: <85pq88c0nj.fsf@iznogoud.viz> Thread-Index: Ac1blLQwdbpOp9buQ7apt9ZGsQ8WvwAAHQqg X-MimeOLE: Produced By Microsoft MimeOLE V6.00.2900.6157 X-Source-IP: acsinet22.oracle.com [141.146.126.238] X-Spam-Score: -6.9 (------) X-Debbugs-Envelope-To: 11862 Cc: 11862@debbugs.gnu.org, 'Richard Stallman' X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.13 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Sender: debbugs-submit-bounces@debbugs.gnu.org Errors-To: debbugs-submit-bounces@debbugs.gnu.org X-Spam-Score: -6.9 (------) > > 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#SECTION001150000000000 000000 And there is this, from the book "Successful Lisp": http://psg.com/~dlamkins/sl/chapter03-06.html From debbugs-submit-bounces@debbugs.gnu.org Fri Jul 06 16:47:24 2012 Received: (at 11862) by debbugs.gnu.org; 6 Jul 2012 20:47:24 +0000 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 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 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== Received: by 10.68.223.129 with SMTP id qu1mr39325807pbc.165.1341607338005; Fri, 06 Jul 2012 13:42:18 -0700 (PDT) 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) Subject: Splitting and simplifying [PATCH 8/9] Date: Fri, 06 Jul 2012 20:06:38 -0000 From: Michael Witten To: Drew Adams Message-ID: <31927313f03b410aaa9830427ff3a0c1-mfwitten@gmail.com> In-Reply-To: References: <22f1c29cd7e44a3e91ca67e534dc03a4-mfwitten@gmail.com> <3c1c3c1cfe3840e19551bfd0424eb99d-mfwitten@gmail.com> <0c2cb6909a904ffeb3010bf4ca2e40b2-mfwitten@gmail.com> <85pq88c0nj.fsf@iznogoud.viz> X-Spam-Score: -2.6 (--) X-Debbugs-Envelope-To: 11862 Cc: 11862@debbugs.gnu.org, Wolfgang Jenkner , Richard Stallman X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.13 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Sender: debbugs-submit-bounces@debbugs.gnu.org Errors-To: debbugs-submit-bounces@debbugs.gnu.org X-Spam-Score: -2.6 (--) 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. From debbugs-submit-bounces@debbugs.gnu.org Fri Jul 06 16:47:45 2012 Received: (at 11862) by debbugs.gnu.org; 6 Jul 2012 20:47:45 +0000 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 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 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== Received: by 10.68.230.68 with SMTP id sw4mr8182264pbc.142.1341607363298; Fri, 06 Jul 2012 13:42:43 -0700 (PDT) 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) Subject: [PATCH 8a/9] doc/lispref/intro.texi: Introduce the term `value' early on Date: Fri, 06 Jul 2012 20:17:05 -0000 From: Michael Witten To: Drew Adams Message-ID: <0176eb16f5a643f89eb12633f213a542-mfwitten@gmail.com> In-Reply-To: <31927313f03b410aaa9830427ff3a0c1-mfwitten@gmail.com> References: <22f1c29cd7e44a3e91ca67e534dc03a4-mfwitten@gmail.com> <3c1c3c1cfe3840e19551bfd0424eb99d-mfwitten@gmail.com> <0c2cb6909a904ffeb3010bf4ca2e40b2-mfwitten@gmail.com> <85pq88c0nj.fsf@iznogoud.viz> <31927313f03b410aaa9830427ff3a0c1-mfwitten@gmail.com> X-Spam-Score: -2.6 (--) X-Debbugs-Envelope-To: 11862 Cc: 11862@debbugs.gnu.org, Wolfgang Jenkner , Richard Stallman X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.13 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Sender: debbugs-submit-bounces@debbugs.gnu.org Errors-To: debbugs-submit-bounces@debbugs.gnu.org X-Spam-Score: -2.6 (--) 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 From debbugs-submit-bounces@debbugs.gnu.org Fri Jul 06 16:48:06 2012 Received: (at 11862) by debbugs.gnu.org; 6 Jul 2012 20:48:07 +0000 Received: from localhost ([127.0.0.1]:53254 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1SnFRe-0007W7-JT for submit@debbugs.gnu.org; Fri, 06 Jul 2012 16:48:06 -0400 Received: from mail-pb0-f44.google.com ([209.85.160.44]:55358) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1SnFRa-0007UV-GG for 11862@debbugs.gnu.org; Fri, 06 Jul 2012 16:48:04 -0400 Received: by mail-pb0-f44.google.com with SMTP id wy7so14032056pbc.3 for <11862@debbugs.gnu.org>; Fri, 06 Jul 2012 13:43:02 -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=YfjDT0B/SIDx1o/twOwArjlSRlH8iyvwtSAwwUinEf4=; b=WFTGJ+oIBq1YvGAKSa6fhJ62nQErQXayr+nf7WdqIW+KXzCREK+qEn2HuZIJTRoeki ReE94pAQ3CM5KSZjCFfCeYFyOazbpHgwZQkzpiJTiAdlrHY55AQy5PhAJRqTbXYa2jN2 ORRweawc3+1m8JtDC3vEjqrAbEDgdd+XYP9u2uImWo7vP+stsnnziuf+wBK0gJX42YKJ +w0HBi6p1nqvuQs0ojYrNtWQHAgVqXa49LeL/HUoQ1NlnXOYhNhPmWzgJPNLIUF/Qo2L 9c9CGh/oXBdKJW76RDUxRLv8PMgmxEy0IYLHBqe96tTQf13GwkyjSVTmD2zX5W2Jh/DR xgmw== Received: by 10.68.201.7 with SMTP id jw7mr39462019pbc.60.1341607382290; Fri, 06 Jul 2012 13:43:02 -0700 (PDT) Received: from gmail.com ([188.127.231.134]) by mx.google.com with ESMTPS id nv6sm22490091pbc.42.2012.07.06.13.42.57 (version=TLSv1/SSLv3 cipher=OTHER); Fri, 06 Jul 2012 13:43:01 -0700 (PDT) Subject: [PATCH 8b/2] doc/lispref/intro.texi: Reduce and reorganize node `A sample Variable Description' Date: Fri, 06 Jul 2012 20:18:15 -0000 From: Michael Witten To: Drew Adams Message-ID: <8c3793fd59b640d4887f7f0965fbecda-mfwitten@gmail.com> In-Reply-To: <31927313f03b410aaa9830427ff3a0c1-mfwitten@gmail.com> References: <22f1c29cd7e44a3e91ca67e534dc03a4-mfwitten@gmail.com> <3c1c3c1cfe3840e19551bfd0424eb99d-mfwitten@gmail.com> <0c2cb6909a904ffeb3010bf4ca2e40b2-mfwitten@gmail.com> <85pq88c0nj.fsf@iznogoud.viz> <31927313f03b410aaa9830427ff3a0c1-mfwitten@gmail.com> X-Spam-Score: -2.6 (--) X-Debbugs-Envelope-To: 11862 Cc: 11862@debbugs.gnu.org, Wolfgang Jenkner , Richard Stallman X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.13 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Sender: debbugs-submit-bounces@debbugs.gnu.org Errors-To: debbugs-submit-bounces@debbugs.gnu.org X-Spam-Score: -2.6 (--) The description of `variable' is removed; such a descriptin is better placed in the node `Variables'. Moreover, this change is consistent with the text of the sibling node, `A Sample Function Description', which does not give such a description for a function, instead leaving that complex topic to more appropriate nodes (such as node `Functions'). The term `user options' is moved to the bottom of the node. --- doc/lispref/intro.texi | 17 +++++++---------- 1 file changed, 7 insertions(+), 10 deletions(-) diff --git a/doc/lispref/intro.texi b/doc/lispref/intro.texi index 0766a23..b62bceb 100644 --- a/doc/lispref/intro.texi +++ b/doc/lispref/intro.texi @@ -447,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 @@ -462,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 -- 1.7.11.1.29.gf71be5c From debbugs-submit-bounces@debbugs.gnu.org Sat Jul 07 05:23:48 2012 Received: (at 11862) by debbugs.gnu.org; 7 Jul 2012 09:23:48 +0000 Received: from localhost ([127.0.0.1]:53854 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1SnREx-0000lk-SC for submit@debbugs.gnu.org; Sat, 07 Jul 2012 05:23:48 -0400 Received: from fencepost.gnu.org ([208.118.235.10]:46483) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1SnREv-0000ld-Sg for 11862@debbugs.gnu.org; Sat, 07 Jul 2012 05:23:46 -0400 Received: from rms by fencepost.gnu.org with local (Exim 4.71) (envelope-from ) id 1SnRA0-0006EW-6r; Sat, 07 Jul 2012 05:18:40 -0400 Date: Sat, 07 Jul 2012 05:18:40 -0400 Message-Id: Content-Type: text/plain; charset=ISO-8859-15 From: Richard Stallman To: Wolfgang Jenkner In-reply-to: <85pq88c0nj.fsf@iznogoud.viz> (message from Wolfgang Jenkner on Fri, 06 Jul 2012 17:55:55 +0200) Subject: Re: bug#11862: [PATCH 8/9 v3] doc/lispref/intro.texi: More precise language for what a variable is References: <22f1c29cd7e44a3e91ca67e534dc03a4-mfwitten@gmail.com> <3c1c3c1cfe3840e19551bfd0424eb99d-mfwitten@gmail.com> <0c2cb6909a904ffeb3010bf4ca2e40b2-mfwitten@gmail.com> <85pq88c0nj.fsf@iznogoud.viz> X-Spam-Score: -6.9 (------) X-Debbugs-Envelope-To: 11862 Cc: 11862@debbugs.gnu.org, mfwitten@gmail.com, drew.adams@oracle.com X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.13 Precedence: list Reply-To: rms@gnu.org List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Sender: debbugs-submit-bounces@debbugs.gnu.org Errors-To: debbugs-submit-bounces@debbugs.gnu.org X-Spam-Score: -6.9 (------) In Lisp, binding a variable and setting a variable are different operations. This binds the variable foo: (let (foo) ...) This sets the variable foo: (setq foo ...) If anything in our Lisp manuals makes this difference blurry, it ought to be fixed. -- Dr Richard Stallman President, Free Software Foundation 51 Franklin St Boston MA 02110 USA www.fsf.org www.gnu.org Skype: No way! That's nonfree (freedom-denying) software. Use Ekiga or an ordinary phone call From debbugs-submit-bounces@debbugs.gnu.org Sun Jul 08 00:46:30 2012 Received: (at 11862) by debbugs.gnu.org; 8 Jul 2012 04:46:30 +0000 Received: from localhost ([127.0.0.1]:55764 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1SnjO9-0007lK-SG for submit@debbugs.gnu.org; Sun, 08 Jul 2012 00:46:30 -0400 Received: from fencepost.gnu.org ([208.118.235.10]:59137) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1SnjO6-0007lC-GK for 11862@debbugs.gnu.org; Sun, 08 Jul 2012 00:46:27 -0400 Received: from cm162.gamma80.maxonline.com.sg ([202.156.80.162]:54547 helo=ulysses) by fencepost.gnu.org with esmtpsa (TLS1.0:DHE_RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1SnjJ7-0000as-0n; Sun, 08 Jul 2012 00:41:17 -0400 From: Chong Yidong To: Michael Witten Subject: Re: bug#11862 [Copyright assignment] References: <22f1c29cd7e44a3e91ca67e534dc03a4-mfwitten@gmail.com> <3c1c3c1cfe3840e19551bfd0424eb99d-mfwitten@gmail.com> <0c2cb6909a904ffeb3010bf4ca2e40b2-mfwitten@gmail.com> Date: Sun, 08 Jul 2012 12:41:09 +0800 In-Reply-To: <0c2cb6909a904ffeb3010bf4ca2e40b2-mfwitten@gmail.com> (Michael Witten's message of "Fri, 06 Jul 2012 08:07:31 -0000") Message-ID: <87sjd2lva2.fsf_-_@gnu.org> User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/24.1.50 (gnu/linux) MIME-Version: 1.0 Content-Type: text/plain X-Spam-Score: -6.9 (------) X-Debbugs-Envelope-To: 11862 Cc: 11862@debbugs.gnu.org X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.13 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Sender: debbugs-submit-bounces@debbugs.gnu.org Errors-To: debbugs-submit-bounces@debbugs.gnu.org X-Spam-Score: -6.9 (------) If you intend to continue making corrections to the Lisp manual, we will need a copyright assignment for your contributions. Would you be willing to sign one? If so, please email the following information to fsf-records@gnu.org, and they will send you the assignment form for your past and future changes. Please use your full name as the subject line of the message. [What is your full legal name?] [What is the name of the program or package you're contributing to?] [Did you copy any files or text written by someone else in these changes? Even if that material is free software, we need to know about it.] [Do you have an employer who might have a basis to claim to own your changes? Do you attend a school which might make such a claim?] [For the copyright registration, what country are you a citizen of?] [What year were you born?] [Please write your email address here.] [Please write your snail address here.] [Which files have you changed so far, and which new files have you written so far?] From unknown Sat Jun 14 19:04:59 2025 Received: (at fakecontrol) by fakecontrolmessage; To: internal_control@debbugs.gnu.org From: Debbugs Internal Request Subject: Internal Control Message-Id: bug archived. Date: Sun, 05 Aug 2012 11:24:03 +0000 User-Agent: Fakemail v42.6.9 # This is a fake control message. # # The action: # bug archived. thanks # This fakemail brought to you by your local debbugs # administrator