Mercurial > hg > xemacs-beta

diff man/lispref/variables.texi @ 5361:62b9ef1ed4ac

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
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 755ae5b97edb
children 9fae6227ede5
line wrap: on
line diff
--- a/man/lispref/variables.texi	Sat Feb 19 11:03:46 2011 +0000
+++ b/man/lispref/variables.texi	Tue Mar 01 14:18:45 2011 +0000
@@ -168,7 +168,7 @@
   The special operators @code{let} and @code{let*} exist to create
 local bindings.
 
-@defspec let (bindings@dots{}) forms@dots{}
+@deffn {Special Operator} let (bindings@dots{}) forms@dots{}
 This special operator binds variables according to @var{bindings} and then
 evaluates all of the @var{forms} in textual order.  The @code{let}-form
 returns the value of the last form in @var{forms}.
@@ -196,9 +196,9 @@
      @result{} (1 2)
 @end group
 @end example
-@end defspec
+@end deffn
 
-@defspec let* (bindings@dots{}) forms@dots{}
+@deffn {Special Operator} let* (bindings@dots{}) forms@dots{}
 This special operator is like @code{let}, but it binds each variable right
 after computing its local value, before computing the local value for
 the next variable.  Therefore, an expression in @var{bindings} can
@@ -218,7 +218,7 @@
      @result{} (1 1)
 @end group
 @end example
-@end defspec
+@end deffn
 
   Here is a complete list of the other facilities that create local
 bindings:
@@ -403,7 +403,7 @@
 files, and override the default values given in the definitions.  For
 this reason, user options must be defined with @code{defvar}.
 
-@defspec defvar symbol [value [doc-string]]
+@deffn {Special Operator} defvar symbol [value [doc-string]]
 This special operator defines @var{symbol} as a value and initializes it.
 The definition informs a person reading your code that @var{symbol} is
 used as a variable that programs are likely to set or change.  It is
@@ -491,9 +491,9 @@
 
 The @code{defvar} form returns @var{symbol}, but it is normally used
 at top level in a file where its value does not matter.
-@end defspec
+@end deffn
 
-@defspec defconst symbol [value [doc-string]]
+@deffn {Special Operator} defconst symbol [value [doc-string]]
 This special operator defines @var{symbol} as a value and initializes it.
 It informs a person reading your code that @var{symbol} has a global
 value, established here, that will not normally be changed or locally
@@ -530,7 +530,7 @@
      @result{} 3
 @end group
 @end example
-@end defspec
+@end deffn
 
 @defun user-variable-p variable
 @cindex user option
@@ -615,7 +615,7 @@
 form @code{setq}.  When you need to compute the choice of variable at
 run time, use the function @code{set}.
 
-@defspec setq [symbol form]@dots{}
+@deffn {Special Operator} setq [symbol form]@dots{}
 This special operator is the most common method of changing a variable's
 value.  Each @var{symbol} is given a new value, which is the result of
 evaluating the corresponding @var{form}.  The most-local existing
@@ -655,7 +655,7 @@
      @result{} 11
 @end group
 @end example
-@end defspec
+@end deffn
 
 @defun set symbol value
 This function sets @var{symbol}'s value to @var{value}, then returns
@@ -1253,7 +1253,7 @@
 @code{symbol-value}.
 @end defun
 
-@defspec setq-default symbol value
+@deffn {Special Operator} setq-default symbol value
 This sets the default value of @var{symbol} to @var{value}.  It does not
 evaluate @var{symbol}, but does evaluate @var{value}.  The value of the
 @code{setq-default} form is @var{value}.
@@ -1314,7 +1314,7 @@
      @result{} another-default
 @end group
 @end example
-@end defspec
+@end deffn
 
 @defun set-default symbol value
 This function is like @code{setq-default}, except that @var{symbol} is