comparison man/lispref/compile.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 9151417c3852
children a46c5c8d6564
comparison
equal deleted inserted replaced
5359:f5a5501814f5 5361:62b9ef1ed4ac
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 @defspec eval-and-compile body 694 @deffn {Special Operator} 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 defspec 702 @end deffn
703 703
704 @defspec eval-when-compile body 704 @deffn {Special Operator} 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 defspec 715 @end deffn
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