[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
bug#11862: [PATCH 4/9] doc/lispref/intro.texi: More precise language
From: |
Michael Witten |
Subject: |
bug#11862: [PATCH 4/9] doc/lispref/intro.texi: More precise language |
Date: |
Wed, 04 Jul 2012 20:15:48 -0000 |
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
- bug#11862: [PATCH 0/9] doc/lispref/intro.texi: Copyediting, Michael Witten, 2012/07/04
- bug#11862: [PATCH 1/9] doc/lispref/intro.texi: Offset modifier with a comma, Michael Witten, 2012/07/04
- bug#11862: [PATCH 2/9] doc/lispref/intro.texi: `can' -> `may', Michael Witten, 2012/07/04
- bug#11862: [PATCH 7/9] doc/lispref/intro.texi: `optional' -> `&optional';, Michael Witten, 2012/07/04
- bug#11862: [PATCH 5/9] doc/lispref/intro.texi: Use singular form in a sentence, Michael Witten, 2012/07/04
- bug#11862: [PATCH 4/9] doc/lispref/intro.texi: More precise language,
Michael Witten <=
- bug#11862: [PATCH 3/9] doc/lispref/intro.texi: Eradicate that pesky future tense, Michael Witten, 2012/07/04
- bug#11862: [PATCH 8/9] doc/lispref/intro.texi: More precise language for, Michael Witten, 2012/07/04
- bug#11862: [PATCH 8/9] doc/lispref/intro.texi: More precise language for, Richard Stallman, 2012/07/05
- bug#11862: [PATCH 8/9 v2] doc/lispref/intro.texi: More precise language for what a variable is, Michael Witten, 2012/07/05
- bug#11862: [PATCH 8/9 v2] doc/lispref/intro.texi: More preciselanguage for what a variable is, Drew Adams, 2012/07/05
- bug#11862: [PATCH 8/9 v3] doc/lispref/intro.texi: More precise language for what a variable is, Michael Witten, 2012/07/06
- bug#11862: [PATCH 8/9 v3] doc/lispref/intro.texi: More precise language for what a variable is, Wolfgang Jenkner, 2012/07/06
- bug#11862: [PATCH 8/9 v3] doc/lispref/intro.texi: More precise language for what a variable is, Drew Adams, 2012/07/06