From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Michael Witten Newsgroups: gmane.emacs.bugs Subject: bug#11862: [PATCH 4/9] doc/lispref/intro.texi: More precise language Date: Wed, 04 Jul 2012 20:15:48 -0000 Message-ID: <5d871479d57e4d94a538f7f27be2c620-mfwitten@gmail.com> References: NNTP-Posting-Host: plane.gmane.org X-Trace: dough.gmane.org 1341434189 8324 80.91.229.3 (4 Jul 2012 20:36:29 GMT) X-Complaints-To: usenet@dough.gmane.org NNTP-Posting-Date: Wed, 4 Jul 2012 20:36:29 +0000 (UTC) To: 11862@debbugs.gnu.org Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Wed Jul 04 22:36:29 2012 Return-path: Envelope-to: geb-bug-gnu-emacs@m.gmane.org Original-Received: from lists.gnu.org ([208.118.235.17]) by plane.gmane.org with esmtp (Exim 4.69) (envelope-from ) id 1SmWJF-0002u0-Do for geb-bug-gnu-emacs@m.gmane.org; Wed, 04 Jul 2012 22:36:25 +0200 Original-Received: from localhost ([::1]:38200 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1SmWJE-0007dX-Bg for geb-bug-gnu-emacs@m.gmane.org; Wed, 04 Jul 2012 16:36:24 -0400 Original-Received: from eggs.gnu.org ([208.118.235.92]:35826) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1SmWJ7-0007Ob-HC for bug-gnu-emacs@gnu.org; Wed, 04 Jul 2012 16:36:18 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1SmWJ5-0003V6-FN for bug-gnu-emacs@gnu.org; Wed, 04 Jul 2012 16:36:17 -0400 Original-Received: from debbugs.gnu.org ([140.186.70.43]:39049) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1SmWJ5-0003Uu-9L for bug-gnu-emacs@gnu.org; Wed, 04 Jul 2012 16:36:15 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.72) (envelope-from ) id 1SmWNj-0006Wx-Fo for bug-gnu-emacs@gnu.org; Wed, 04 Jul 2012 16:41:03 -0400 X-Loop: help-debbugs@gnu.org Resent-From: Michael Witten Original-Sender: debbugs-submit-bounces@debbugs.gnu.org Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Wed, 04 Jul 2012 20:41:03 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 11862 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: patch X-Debbugs-Original-To: bug-gnu-emacs@gnu.org Original-Received: via spool by submit@debbugs.gnu.org id=B.134143441825015 (code B ref -1); Wed, 04 Jul 2012 20:41:03 +0000 Original-Received: (at submit) by debbugs.gnu.org; 4 Jul 2012 20:40:18 +0000 Original-Received: from localhost ([127.0.0.1]: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 Original-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 Original-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 Original-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 Original-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 Original-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 Original-Received: from mail-lb0-f169.google.com ([209.85.217.169]:47536) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1SmW2X-0006Fy-IE for bug-gnu-emacs@gnu.org; Wed, 04 Jul 2012 16:19:09 -0400 Original-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== Original-Received: by 10.112.17.227 with SMTP id r3mr10607816lbd.41.1341433148448; Wed, 04 Jul 2012 13:19:08 -0700 (PDT) Original-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) In-Reply-To: X-detected-operating-system: by eggs.gnu.org: Genre and OS details not recognized. X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6 (newer, 3) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.13 Precedence: list X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6 (newer, 2) X-Received-From: 140.186.70.43 X-BeenThere: bug-gnu-emacs@gnu.org List-Id: "Bug reports for GNU Emacs, the Swiss army knife of text editors" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Original-Sender: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Xref: news.gmane.org gmane.emacs.bugs:61588 Archived-At: 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