Here is the complete list of the error symbols in standard Emacs,
grouped by concept. The list includes each symbol's message (on the
-@code{error-message} property of the symbol), and a cross reference to a
+@code{error-message} property of the symbol) and a cross reference to a
description of how the error can occur.
- Each error symbol has an @code{error-conditions} property which is a
-list of symbols. Normally, this list includes the error symbol itself,
+ Each error symbol has an @code{error-conditions} property that is a
+list of symbols. Normally this list includes the error symbol itself
and the symbol @code{error}. Occasionally it includes additional
-symbols, which are intermediate classifications, narrower than @code{error}
-but broader than a single error symbol. For example, all the errors
-in accessing files have the condition @code{file-error}.
+symbols, which are intermediate classifications, narrower than
+@code{error} but broader than a single error symbol. For example, all
+the errors in accessing files have the condition @code{file-error}.
As a special exception, the error symbol @code{quit} does not have the
condition @code{error}, because quitting is not considered an error.
@xref{Input Functions}.
@item file-error
-This error, and its subcategories, do not have
-error-strings, because the error message is constructed from the data
-items alone when the error condition @code{file-error} is present.@*
+This error and its subcategories do not have error-strings, because the
+error message is constructed from the data items alone when the error
+condition @code{file-error} is present.@*
@xref{Files}.
@item file-locked
@item file-supersession
This is a @code{file-error}.@*
-@xref{Buffer Modification}.
+@xref{Modification Time}.
@item invalid-function
@code{"Invalid function"}@*
@node Standard Hooks, Antinews, Standard Keymaps, Top
@appendix Standard Hooks
-The following is a list of hook variables which let you provide
+The following is a list of hook variables that let you provide
functions to be called from within Emacs on suitable occasions.
-Most of these variables have names ending with @samp{-hook} are
-@dfn{normal hooks}, that are run with @code{run-hooks}. The value of
-such a hook is a list of functions. The recommended way to put a new
+Most of these variables have names ending with @samp{-hook}. They are
+@dfn{normal hooks}, run by means of @code{run-hooks}. The value of such
+a hook is a list of functions. The recommended way to put a new
function on such a hook is to call @code{add-hook}. @xref{Hooks}, for
more information about using hooks.
The variables whose names end in @samp{-function} have single functions
as their values. Usually there is a specific reason why the variable is
-not a normal hook, such as, the need to pass an argument to the
-function. (In older Emacs versions, some of these variables had
-names ending in @samp{-hook} even though they were not normal hooks.)
+not a normal hook, such as the need to pass arguments to the function.
+(In older Emacs versions, some of these variables had names ending in
+@samp{-hook} even though they were not normal hooks.)
-The variables whose names end in @samp{-hooks} have lists of functions
-as their values, but these functions are called in a special way (they
-are passed arguments, or else their values are used).
+The variables whose names end in @samp{-hooks} or @samp{-functions} have
+lists of functions as their values, but these functions are called in a
+special way (they are passed arguments, or else their values are used).
@c !!! need xref to where each hook is documented or else document it
@c by specifying what is expected, and when it is called relative to
@c The title "Standard Buffer-Local Variables" is too long for
@c smallbook. --rjc 30mar92
- The table below shows all of the variables that are automatically
-local (when set) in each buffer in Emacs Version 18 with the common
-packages loaded.
+ The table below lists the general-purpose Emacs variables that are
+automatically local (when set) in each buffer. Many Lisp packages
+define such variables for their internal use; we don't list them here.
@table @code
@item abbrev-mode
The following symbols are used as the names for various keymaps.
Some of these exist when Emacs is first started, others are
-only loaded when their respective mode is used. This is not
+loaded only when their respective mode is used. This is not
an exhaustive list.
Almost all of these maps are used as local maps. Indeed, of the modes
@item c-mode-map
@vindex c-mode-map
-A sparse keymap used in C mode as a local map.
+A sparse keymap used by C mode.
@item command-history-map
@vindex command-history-map
@item emacs-lisp-mode-map
@vindex emacs-lisp-mode-map
-A sparse keymap used in Emacs Lisp mode.
+A sparse keymap used by Emacs Lisp mode.
@item function-key-map
@vindex function-key-map
@item key-translation-map
@vindex key-translation-map
-Another keymap for translating keys. This one overrides ordinary key
-bindings.
+A keymap for translating keys. This one overrides ordinary key
+bindings, unlike @code{function-key-map}.
@item lisp-interaction-mode-map
@vindex lisp-interaction-mode-map
-A sparse keymap used in Lisp mode.
+A sparse keymap used by Lisp mode.
@item lisp-mode-map
@vindex lisp-mode-map
-A sparse keymap used in Lisp mode.
+A sparse keymap used by Lisp mode.
@item mode-specific-map
The keymap for characters following @kbd{C-c}. Note, this is in the
@item occur-mode-map
@vindex occur-mode-map
-A local keymap used in Occur mode.
+A local keymap used by Occur mode.
@item query-replace-map
A local keymap used for responses in @code{query-replace} and related
projects / emacs.git / commitdiff