comparison man/lispref/symbols.texi @ 4905:755ae5b97edb

Change "special form" to "special operator" in our sources. Add a compatible function alias, and the relevant manual index entries. src/ChangeLog addition: 2010-01-31 Aidan Kehoe <kehoea@parhasard.net> * symbols.c (Fspecial_operator_p, syms_of_symbols): * eval.c (print_subr, Finteractive_p, Ffuncall) (Ffunction_min_args, Ffunction_max_args, vars_of_eval): * editfns.c: * data.c (Fsubr_max_args): * doc.c (Fbuilt_in_symbol_file): Change "special form" to "special operator" in our sources. man/ChangeLog addition: 2010-01-31 Aidan Kehoe <kehoea@parhasard.net> * xemacs/programs.texi (Defuns): * lispref/variables.texi (Local Variables, Defining Variables) (Setting Variables, Default Value): * lispref/symbols.texi (Definitions): * lispref/searching.texi (Saving Match Data): * lispref/positions.texi (Excursions, Narrowing): * lispref/objects.texi (Primitive Function Type): * lispref/macros.texi (Defining Macros, Backquote): * lispref/lispref.texi (Top): * lispref/intro.texi (A Sample Function Description): * lispref/help.texi (Help Functions): * lispref/functions.texi (What Is a Function, Simple Lambda) (Defining Functions, Calling Functions, Anonymous Functions): * lispref/frames.texi (Input Focus): * lispref/eval.texi (Forms, Function Indirection) (Special Operators, Quoting): * lispref/edebug-inc.texi (Instrumenting) (Specification Examples): * lispref/debugging.texi (Internals of Debugger): * lispref/control.texi (Control Structures, Sequencing): (Conditionals, Combining Conditions, Iteration): (Catch and Throw, Handling Errors): * lispref/commands.texi (Defining Commands, Using Interactive): Terminology change; special operator -> special form. Don't attempt to change this in texinfo.texi or cl.texi, which use macros I don't understand. * lispref/macros.texi (Defining Macros): Give an anonymous macro example here. * lispref/positions.texi (Excursions): Correct some documentation that called a couple of macros special forms. * lispref/searching.texi (Saving Match Data): Drop some documentation of how to write code that works with Emacs 18. * lispref/specifiers.texi (Adding Specifications): Correct this; #'let-specifier is a macro, not a special operator. * lispref/windows.texi (Window Configurations) (Selecting Windows): Correct this, #'save-selected-window and #'save-window-excursion are macros, not special operators. lisp/ChangeLog addition: 2010-01-31 Aidan Kehoe <kehoea@parhasard.net> * obsolete.el: * loadhist.el (symbol-file): * help.el (describe-function-1): * bytecomp.el: (byte-compile-save-current-buffer): * byte-optimize.el (byte-optimize-form-code-walker): * subr.el (subr-arity): Change "special form" to "special operator" in these files, it's the more logical term. * subr.el (special-form-p): Provide this alias for #'special-operator-p.
author Aidan Kehoe <kehoea@parhasard.net>
date Sun, 31 Jan 2010 20:28:01 +0000
parents 6780963faf78
children febc025c4e0c
comparison
equal deleted inserted replaced
4904:e91e3e353805 4905:755ae5b97edb
130 130
131 @node Definitions 131 @node Definitions
132 @section Defining Symbols 132 @section Defining Symbols
133 @cindex definition of a symbol 133 @cindex definition of a symbol
134 134
135 A @dfn{definition} in Lisp is a special form that announces your 135 A @dfn{definition} in Lisp is a special operator that announces your
136 intention to use a certain symbol in a particular way. In XEmacs Lisp, 136 intention to use a certain symbol in a particular way. In XEmacs Lisp,
137 you can define a symbol as a variable, or define it as a function (or 137 you can define a symbol as a variable, or define it as a function (or
138 macro), or both independently. 138 macro), or both independently.
139 139
140 A definition construct typically specifies a value or meaning for the 140 A definition construct typically specifies a value or meaning for the
141 symbol for one kind of use, plus documentation for its meaning when used 141 symbol for one kind of use, plus documentation for its meaning when used
142 in this way. Thus, when you define a symbol as a variable, you can 142 in this way. Thus, when you define a symbol as a variable, you can
143 supply an initial value for the variable, plus documentation for the 143 supply an initial value for the variable, plus documentation for the
144 variable. 144 variable.
145 145
146 @code{defvar} and @code{defconst} are special forms that define a 146 @code{defvar} and @code{defconst} are special operators that define a
147 symbol as a global variable. They are documented in detail in 147 symbol as a global variable. They are documented in detail in
148 @ref{Defining Variables}. 148 @ref{Defining Variables}.
149 149
150 @code{defun} defines a symbol as a function, creating a lambda 150 @code{defun} defines a symbol as a function, creating a lambda
151 expression and storing it in the function cell of the symbol. This 151 expression and storing it in the function cell of the symbol. This