Mercurial > hg > xemacs-beta
comparison man/lispref/eval.texi @ 5361:62b9ef1ed4ac
Change "special form" to "special operator" in the manuals, too
2011-03-01 Aidan Kehoe <kehoea@parhasard.net>
* lispref/commands.texi (Using Interactive):
* lispref/compile.texi (Eval During Compile):
* lispref/compile.texi (Compiled-Function Objects):
* lispref/control.texi (Sequencing):
* lispref/control.texi (Conditionals):
* lispref/control.texi (Combining Conditions):
* lispref/control.texi (Iteration):
* lispref/control.texi (Catch and Throw):
* lispref/control.texi (Handling Errors):
* lispref/control.texi (Cleanups):
* lispref/display.texi (Temporary Displays):
* lispref/eval.texi (Quoting):
* lispref/eval.texi (Multiple values):
* lispref/frames.texi (Input Focus):
* lispref/functions.texi (Argument List):
* lispref/functions.texi (Defining Functions):
* lispref/functions.texi (Anonymous Functions):
* lispref/internationalization.texi (Level 3 Primitives):
* lispref/internationalization.texi (Domain Specification):
* lispref/intro.texi (A Sample Function Description):
* lispref/intro.texi (A Sample Variable Description):
* lispref/lists.texi (Sets And Lists):
* lispref/macros.texi (Defining Macros):
* lispref/macros.texi (Backquote):
* lispref/positions.texi (Excursions):
* lispref/positions.texi (Narrowing):
* lispref/searching.texi (Saving Match Data):
* lispref/sequences.texi (Sequence Functions):
* lispref/sequences.texi (Array Functions):
* lispref/specifiers.texi (Adding Specifications):
* lispref/variables.texi (Local Variables):
* lispref/variables.texi (Defining Variables):
* lispref/variables.texi (Setting Variables):
* lispref/variables.texi (Default Value):
* lispref/windows.texi (Selecting Windows):
* lispref/windows.texi (Window Configurations):
No longer use @defspec, since we no longer use the term "special
form"; instead use @deffn {Special Operator}. Unfortunately
there's no way in texinfo to redefine @defspec in one place.
| author | Aidan Kehoe <kehoea@parhasard.net> |
|---|---|
| date | Tue, 01 Mar 2011 14:18:45 +0000 |
| parents | 378a34562cbe |
| children | a46c5c8d6564 |
comparison
equal
deleted
inserted
replaced
| 5359:f5a5501814f5 | 5361:62b9ef1ed4ac |
|---|---|
| 661 without evaluating it. This provides a way to include constant symbols | 661 without evaluating it. This provides a way to include constant symbols |
| 662 and lists, which are not self-evaluating objects, in a program. (It is | 662 and lists, which are not self-evaluating objects, in a program. (It is |
| 663 not necessary to quote self-evaluating objects such as numbers, strings, | 663 not necessary to quote self-evaluating objects such as numbers, strings, |
| 664 and vectors.) | 664 and vectors.) |
| 665 | 665 |
| 666 @defspec quote object | 666 @deffn {Special Operator} quote object |
| 667 This special operator returns @var{object}, without evaluating it. | 667 This special operator returns @var{object}, without evaluating it. |
| 668 @end defspec | 668 @end deffn |
| 669 | 669 |
| 670 @cindex @samp{'} for quoting | 670 @cindex @samp{'} for quoting |
| 671 @cindex quoting using apostrophe | 671 @cindex quoting using apostrophe |
| 672 @cindex apostrophe for quoting | 672 @cindex apostrophe for quoting |
| 673 Because @code{quote} is used so often in programs, Lisp provides a | 673 Because @code{quote} is used so often in programs, Lisp provides a |
| 741 @defun values-list argument | 741 @defun values-list argument |
| 742 This function returns the elements of the lst @var{argument} as multiple | 742 This function returns the elements of the lst @var{argument} as multiple |
| 743 values. | 743 values. |
| 744 @end defun | 744 @end defun |
| 745 | 745 |
| 746 @defspec multiple-value-bind (var@dots{}) values-form forms@dots{} | 746 @deffn {Special Operator} multiple-value-bind (var@dots{}) values-form forms@dots{} |
| 747 This special operator evaluates @var{values-form}, which may return | 747 This special operator evaluates @var{values-form}, which may return |
| 748 multiple values. It then binds the @var{var}s to these respective values, | 748 multiple values. It then binds the @var{var}s to these respective values, |
| 749 as if by @code{let}, and then executes the body @var{forms}. | 749 as if by @code{let}, and then executes the body @var{forms}. |
| 750 If there are more @var{var}s than values, the extra @var{var}s | 750 If there are more @var{var}s than values, the extra @var{var}s |
| 751 are bound to @code{nil}. If there are fewer @var{var}s than | 751 are bound to @code{nil}. If there are fewer @var{var}s than |
| 752 values, the excess values are ignored. | 752 values, the excess values are ignored. |
| 753 @end defspec | 753 @end deffn |
| 754 | 754 |
| 755 @defspec multiple-value-setq (var@dots{}) form | 755 @deffn {Special Operator} multiple-value-setq (var@dots{}) form |
| 756 This special operator evaluates @var{form}, which may return multiple | 756 This special operator evaluates @var{form}, which may return multiple |
| 757 values. It then sets the @var{var}s to these respective values, as if by | 757 values. It then sets the @var{var}s to these respective values, as if by |
| 758 @code{setq}. Extra @var{var}s or values are treated the same as | 758 @code{setq}. Extra @var{var}s or values are treated the same as |
| 759 in @code{multiple-value-bind}. | 759 in @code{multiple-value-bind}. |
| 760 @end defspec | 760 @end deffn |
| 761 | 761 |
| 762 @defspec multiple-value-call function forms@dots{} | 762 @deffn {Special Operator} multiple-value-call function forms@dots{} |
| 763 This special operator evaluates function, discarding any multiple | 763 This special operator evaluates function, discarding any multiple |
| 764 values. It then evaluates @var{forms}, preserving any multiple values, | 764 values. It then evaluates @var{forms}, preserving any multiple values, |
| 765 and calls @var{function} as a function with the results. Conceptually, this | 765 and calls @var{function} as a function with the results. Conceptually, this |
| 766 function is a version of @code{apply'}that by-passes the multiple values | 766 function is a version of @code{apply'}that by-passes the multiple values |
| 767 infrastructure, treating multiple values as intercalated lists. | 767 infrastructure, treating multiple values as intercalated lists. |
| 768 @end defspec | 768 @end deffn |
| 769 | 769 |
| 770 @defspec multiple-value-list form | 770 @deffn {Special Operator} multiple-value-list form |
| 771 This special operator evaluates @var{form} and returns a list of the | 771 This special operator evaluates @var{form} and returns a list of the |
| 772 multiple values given by it. | 772 multiple values given by it. |
| 773 @end defspec | 773 @end deffn |
| 774 | 774 |
| 775 @defspec multiple-value-prog1 first body@dots{} | 775 @deffn {Special Operator} multiple-value-prog1 first body@dots{} |
| 776 This special operator evaluates the form @var{first}, then the | 776 This special operator evaluates the form @var{first}, then the |
| 777 forms @var{body}. It returns the value given by @var{first}, preserving | 777 forms @var{body}. It returns the value given by @var{first}, preserving |
| 778 any multiple values. This is identical to @code{prog1}, except that | 778 any multiple values. This is identical to @code{prog1}, except that |
| 779 @code{prog1} always discards multiple values. | 779 @code{prog1} always discards multiple values. |
| 780 @end defspec | 780 @end deffn |
| 781 | 781 |
| 782 @defspec nth-value n form | 782 @deffn {Special Operator} nth-value n form |
| 783 This special operator evaluates @var{form} and returns the @var{n}th | 783 This special operator evaluates @var{form} and returns the @var{n}th |
| 784 value it gave. @var{n} must be an integer of value zero or more. | 784 value it gave. @var{n} must be an integer of value zero or more. |
| 785 If @var{form} gave insufficient multiple values, @code{nth-value} | 785 If @var{form} gave insufficient multiple values, @code{nth-value} |
| 786 returns @code{nil}. | 786 returns @code{nil}. |
| 787 @end defspec | 787 @end deffn |
| 788 | 788 |
| 789 @defvar multiple-values-limit | 789 @defvar multiple-values-limit |
| 790 This constant describes the exclusive upper bound on the number of | 790 This constant describes the exclusive upper bound on the number of |
| 791 multiple values that @code{values} accepts and that | 791 multiple values that @code{values} accepts and that |
| 792 @code{multiple-value-bind}, etc. will consume. | 792 @code{multiple-value-bind}, etc. will consume. |