diff man/lispref/functions.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 99f8ebc082d9
children 9fae6227ede5
line wrap: on
line diff
--- a/man/lispref/functions.texi	Sat Feb 19 11:03:46 2011 +0000
+++ b/man/lispref/functions.texi	Tue Mar 01 14:18:45 2011 +0000
@@ -337,8 +337,9 @@
 @cindex CL note---default optional arg
 @quotation
 @b{Common Lisp note:} Common Lisp allows the function to specify what
-default value to use when an optional argument is omitted; XEmacs Lisp
-always uses @code{nil}.
+default value to use when an optional argument is omitted; this is
+available in XEmacs Lisp with the @code{defun*} macro, an alternative to
+@code{defun}.
 @end quotation
 
   For example, an argument list that looks like this:
@@ -474,7 +475,7 @@
 is called @dfn{defining a function}, and it is done with the
 @code{defun} special operator.
 
-@defspec defun name argument-list body-forms
+@deffn {Special Operator} defun name argument-list body-forms
 @code{defun} is the usual way to define new Lisp functions.  It
 defines the symbol @var{name} as a function that looks like this:
 
@@ -543,7 +544,7 @@
 without any hesitation or notification.  Redefining a function already
 defined is often done deliberately, and there is no way to distinguish
 deliberate redefinition from unintentional redefinition.
-@end defspec
+@end deffn
 
 @defun define-function name definition
 @defunx defalias name definition
@@ -833,14 +834,14 @@
 In such cases, we usually use the special operator @code{function} instead
 of simple quotation to quote the anonymous function.
 
-@defspec function function-object
+@deffn {Special Operator} function function-object
 @cindex function quoting
 This special operator returns @var{function-object} without evaluating it.
 In this, it is equivalent to @code{quote}.  However, it serves as a
 note to the XEmacs Lisp compiler that @var{function-object} is intended
 to be used only as a function, and therefore can safely be compiled.
 Contrast this with @code{quote}, in @ref{Quoting}.
-@end defspec
+@end deffn
 
   Using @code{function} instead of @code{quote} makes a difference
 inside a function or macro that you are going to compile.  For example: