Mercurial > hg > xemacs-beta
diff man/lispref/eval.texi @ 5547:a46c5c8d6564
Avoid calling various macros "special operators" in the manuals.
2011-08-09 Aidan Kehoe <kehoea@parhasard.net>
* cl.texi (Argument Lists):
* cl.texi (Time of Evaluation):
* cl.texi (Type Predicates):
* cl.texi (Assignment):
* cl.texi (Basic Setf):
* cl.texi (Modify Macros):
* cl.texi (Customizing Setf):
* cl.texi (Dynamic Bindings):
* cl.texi (Lexical Bindings):
* cl.texi (Function Bindings):
* cl.texi (Macro Bindings):
* cl.texi (Conditionals):
* cl.texi (Blocks and Exits):
* cl.texi (Iteration):
* cl.texi (Loop Basics):
* cl.texi (Macros):
* cl.texi (Declarations):
* cl.texi (Property Lists):
* cl.texi (Structures):
* cl.texi (Assertions):
* cl.texi (Efficiency Concerns):
* lispref/compile.texi (Eval During Compile):
* lispref/compile.texi (Compiled-Function Objects):
* lispref/eval.texi (Multiple values):
* lispref/frames.texi (Input Focus):
* lispref/internationalization.texi (Level 3 Primitives):
* lispref/positions.texi (Excursions):
* lispref/positions.texi (Narrowing):
* lispref/searching.texi (Saving Match Data):
* lispref/specifiers.texi (Adding Specifications):
* lispref/windows.texi:
Correct the manuals to avoid using the term "special operator" when
#'special-operator-p would give nil.
author | Aidan Kehoe <kehoea@parhasard.net> |
---|---|
date | Tue, 09 Aug 2011 17:17:44 +0100 |
parents | 62b9ef1ed4ac |
children | 9fae6227ede5 |
line wrap: on
line diff
--- a/man/lispref/eval.texi Mon Aug 08 23:10:47 2011 +0900 +++ b/man/lispref/eval.texi Tue Aug 09 17:17:44 2011 +0100 @@ -743,21 +743,21 @@ values. @end defun -@deffn {Special Operator} multiple-value-bind (var@dots{}) values-form forms@dots{} -This special operator evaluates @var{values-form}, which may return +@defmac multiple-value-bind (var@dots{}) values-form forms@dots{} +This macro evaluates @var{values-form}, which may return multiple values. It then binds the @var{var}s to these respective values, as if by @code{let}, and then executes the body @var{forms}. If there are more @var{var}s than values, the extra @var{var}s are bound to @code{nil}. If there are fewer @var{var}s than values, the excess values are ignored. -@end deffn +@end defmac -@deffn {Special Operator} multiple-value-setq (var@dots{}) form -This special operator evaluates @var{form}, which may return multiple +@defmac multiple-value-setq (var@dots{}) form +This macro evaluates @var{form}, which may return multiple values. It then sets the @var{var}s to these respective values, as if by @code{setq}. Extra @var{var}s or values are treated the same as in @code{multiple-value-bind}. -@end deffn +@end defmac @deffn {Special Operator} multiple-value-call function forms@dots{} This special operator evaluates function, discarding any multiple @@ -767,10 +767,10 @@ infrastructure, treating multiple values as intercalated lists. @end deffn -@deffn {Special Operator} multiple-value-list form -This special operator evaluates @var{form} and returns a list of the +@defmac multiple-value-list form +This macro evaluates @var{form} and returns a list of the multiple values given by it. -@end deffn +@end defmac @deffn {Special Operator} multiple-value-prog1 first body@dots{} This special operator evaluates the form @var{first}, then the @@ -779,12 +779,12 @@ @code{prog1} always discards multiple values. @end deffn -@deffn {Special Operator} nth-value n form -This special operator evaluates @var{form} and returns the @var{n}th +@defmac nth-value n form +This macro evaluates @var{form} and returns the @var{n}th value it gave. @var{n} must be an integer of value zero or more. If @var{form} gave insufficient multiple values, @code{nth-value} returns @code{nil}. -@end deffn +@end defmac @defvar multiple-values-limit This constant describes the exclusive upper bound on the number of