Mercurial > hg > xemacs-beta

comparison man/xemacs-faq.texi @ 4905:755ae5b97edb

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
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 aa5ed11f473b
children b7232de2a937
comparison
equal deleted inserted replaced
4904:e91e3e353805 4905:755ae5b97edb
7779 in Lisp. Thus, there is no performance penalty for using the more 7779 in Lisp. Thus, there is no performance penalty for using the more
7780 readable @code{incf} and @code{push} forms in your compiled code. 7780 readable @code{incf} and @code{push} forms in your compiled code.
7781 7781
7782 @emph{Interpreted} code, on the other hand, must expand these macros 7782 @emph{Interpreted} code, on the other hand, must expand these macros
7783 every time they are executed. For this reason it is strongly 7783 every time they are executed. For this reason it is strongly
7784 recommended that code making heavy use of macros be compiled. (The 7784 recommended that code making heavy use of macros be compiled. A loop
7785 features labelled @dfn{Special Form} instead of @dfn{Function} in this 7785 using @code{incf} a hundred times will execute considerably faster if
7786 manual are macros.) A loop using @code{incf} a hundred times will 7786 compiled, and will also garbage-collect less because the macro expansion
7787 execute considerably faster if compiled, and will also garbage-collect 7787 will not have to be generated, used, and thrown away a hundred times.
7788 less because the macro expansion will not have to be generated, used,
7789 and thrown away a hundred times.
7790 7788
7791 You can find out how a macro expands by using the @code{cl-prettyexpand} 7789 You can find out how a macro expands by using the @code{cl-prettyexpand}
7792 function. 7790 function.
7793 @end quotation 7791 @end quotation
7794 7792
8583 8581
8584 @item 8582 @item
8585 @strong{Frame focus changes}: @code{focus-follows-mouse} works like FSF, 8583 @strong{Frame focus changes}: @code{focus-follows-mouse} works like FSF,
8586 prevents any attempt to permanently change the selected frame; new 8584 prevents any attempt to permanently change the selected frame; new
8587 function @code{focus-frame} sets the window system focus a frame; new 8585 function @code{focus-frame} sets the window system focus a frame; new
8588 special forms @code{save-selected-frame} and @code{with-selected-frame}. 8586 macros @code{save-selected-frame} and @code{with-selected-frame}.
8589 8587
8590 @item 8588 @item
8591 @strong{Window function changes}: @code{select-window} now has optional 8589 @strong{Window function changes}: @code{select-window} now has optional
8592 argument @var{NORECORD} to inhibit recording a buffer change; 8590 argument @var{NORECORD} to inhibit recording a buffer change;
8593 @code{vertical-motion} now correctly handles optional @var{WINDOW} 8591 @code{vertical-motion} now correctly handles optional @var{WINDOW}