Mercurial > hg > xemacs-beta
diff src/eval.c @ 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 | a98ca4640147 |
children | 17362f371cc2 e813cf16c015 |
line wrap: on
line diff
--- a/src/eval.c Sun Jan 31 18:09:57 2010 +0000 +++ b/src/eval.c Sun Jan 31 20:28:01 2010 +0000 @@ -427,7 +427,7 @@ { Lisp_Subr *subr = XSUBR (obj); const CIbyte *header = - (subr->max_args == UNEVALLED) ? "#<special-form " : "#<subr "; + (subr->max_args == UNEVALLED) ? "#<special-operator " : "#<subr "; const CIbyte *name = subr_name (subr); const CIbyte *trailer = subr->prompt ? " (interactive)>" : ">"; @@ -823,7 +823,7 @@ /* The basic special forms */ /************************************************************************/ -/* Except for Fprogn(), the basic special forms below are only called +/* Except for Fprogn(), the basic special operators below are only called from interpreted code. The byte compiler turns them into bytecodes. */ DEFUN ("or", For, 0, UNEVALLED, 0, /* @@ -3302,7 +3302,7 @@ btp = btp->next; /* If this isn't a byte-compiled function, then we may now be - looking at several frames for special forms. Skip past them. */ + looking at several frames for special operators. Skip past them. */ while (btp && btp->nargs == UNEVALLED) btp = btp->next; @@ -4060,7 +4060,7 @@ val = SUBR_FUNCTION (subr, MANY) (fun_nargs, fun_args); PROFILE_EXIT_FUNCTION (); } - else if (max_args == UNEVALLED) /* Can't funcall a special form */ + else if (max_args == UNEVALLED) /* Can't funcall a special operator */ { /* Ugh, ugh, ugh. */ if (EQ (fun, XSYMBOL_FUNCTION (Qthrow))) @@ -4243,7 +4243,7 @@ DEFUN ("function-min-args", Ffunction_min_args, 1, 1, 0, /* Return the minimum number of arguments a function may be called with. The function may be any form that can be passed to `funcall', -any special form, or any macro. +any special operator, or any macro. To check if a function can be called with a specified number of arguments, use `function-allows-args'. @@ -4256,9 +4256,9 @@ DEFUN ("function-max-args", Ffunction_max_args, 1, 1, 0, /* Return the maximum number of arguments a function may be called with. The function may be any form that can be passed to `funcall', -any special form, or any macro. +any special operator, or any macro. If the function takes an arbitrary number of arguments or is -a built-in special form, nil is returned. +a built-in special operator, nil is returned. To check if a function can be called with a specified number of arguments, use `function-allows-args'. @@ -4415,7 +4415,7 @@ A multiple value object is returned by #'values if: -- The number of arguments to #'values is not one, and: - -- Some special form in the call stack is prepared to handle more than + -- Some special operator in the call stack is prepared to handle more than one multiple value. The return value of #'values-list is analogous to that of #'values. @@ -4430,7 +4430,7 @@ objects should be converted to heap allocation at that point. The specific multiple values saved and returned depend on how many - multiple-values special forms in the stack are interested in; for + multiple-values special operators in the stack are interested in; for example, if #'multiple-value-call is somewhere in the call stack, all values passed to #'values will be saved and returned. If an expansion of #'multiple-value-setq with 10 SYMS is the only part of the call stack @@ -7158,8 +7158,8 @@ DEFUN ("backtrace-frame", Fbacktrace_frame, 1, 1, 0, /* Return the function and arguments NFRAMES up from current execution point. -If that frame has not evaluated the arguments yet (or is a special form), -the value is (nil FUNCTION ARG-FORMS...). +If that frame has not evaluated the arguments yet (or involves a special +operator), the value is (nil FUNCTION ARG-FORMS...). If that frame has evaluated its arguments and called its function already, the value is (t FUNCTION ARG-VALUES...). A &rest arg is represented as the tail of the list ARG-VALUES. @@ -7527,7 +7527,7 @@ The exclusive upper bound on the number of multiple values. This applies to `values', `values-list', `multiple-value-bind' and related -macros and special forms. +macros and special operators. */); Vmultiple_values_limit = EMACS_INT_MAX > INT_MAX ? INT_MAX : EMACS_INT_MAX;