Mercurial > hg > xemacs-beta
comparison man/lispref/compile.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 |
comparison
equal
deleted
inserted
replaced
| 5546:d54278e74d71 | 5547:a46c5c8d6564 |
|---|---|
| 689 @section Evaluation During Compilation | 689 @section Evaluation During Compilation |
| 690 | 690 |
| 691 These features permit you to write code to be evaluated during | 691 These features permit you to write code to be evaluated during |
| 692 compilation of a program. | 692 compilation of a program. |
| 693 | 693 |
| 694 @deffn {Special Operator} eval-and-compile body | 694 @defmac eval-and-compile body |
| 695 This form marks @var{body} to be evaluated both when you compile the | 695 This form marks @var{body} to be evaluated both when you compile the |
| 696 containing code and when you run it (whether compiled or not). | 696 containing code and when you run it (whether compiled or not). |
| 697 | 697 |
| 698 You can get a similar result by putting @var{body} in a separate file | 698 You can get a similar result by putting @var{body} in a separate file |
| 699 and referring to that file with @code{require}. Using @code{require} is | 699 and referring to that file with @code{require}. Using @code{require} is |
| 700 preferable if there is a substantial amount of code to be executed in | 700 preferable if there is a substantial amount of code to be executed in |
| 701 this way. | 701 this way. |
| 702 @end deffn | 702 @end defmac |
| 703 | 703 |
| 704 @deffn {Special Operator} eval-when-compile body | 704 @defmac eval-when-compile body |
| 705 This form marks @var{body} to be evaluated at compile time and not when | 705 This form marks @var{body} to be evaluated at compile time and not when |
| 706 the compiled program is loaded. The result of evaluation by the | 706 the compiled program is loaded. The result of evaluation by the |
| 707 compiler becomes a constant which appears in the compiled program. When | 707 compiler becomes a constant which appears in the compiled program. When |
| 708 the program is interpreted, not compiled at all, @var{body} is evaluated | 708 the program is interpreted, not compiled at all, @var{body} is evaluated |
| 709 normally. | 709 normally. |
| 710 | 710 |
| 711 At top level, this is analogous to the Common Lisp idiom | 711 At top level, this is analogous to the Common Lisp idiom |
| 712 @code{(eval-when (compile eval) @dots{})}. Elsewhere, the Common Lisp | 712 @code{(eval-when (compile eval) @dots{})}. Elsewhere, the Common Lisp |
| 713 @samp{#.} reader macro (but not when interpreting) is closer to what | 713 @samp{#.} reader macro (but not when interpreting) is closer to what |
| 714 @code{eval-when-compile} does. | 714 @code{eval-when-compile} does. |
| 715 @end deffn | 715 @end defmac |
| 716 | 716 |
| 717 @node Compiled-Function Objects | 717 @node Compiled-Function Objects |
| 718 @section Compiled-Function Objects | 718 @section Compiled-Function Objects |
| 719 @cindex compiled function | 719 @cindex compiled function |
| 720 @cindex byte-code function | 720 @cindex byte-code function |