Use C-style comments.
[emacs.git] / lispref / errors.texi
blob5c10c3c15bd95945aa1dd8f6c8e0673cf86e2c3a
1 @c -*-texinfo-*-
2 @c This is part of the GNU Emacs Lisp Reference Manual.
3 @c Copyright (C) 1990, 1991, 1992, 1993 Free Software Foundation, Inc. 
4 @c See the file elisp.texi for copying conditions.
5 @setfilename ../info/errors
6 @node Standard Errors, Standard Buffer-Local Variables, GNU Emacs Internals, Top
7 @appendix Standard Errors
9   Here is the complete list of the error symbols in standard Emacs,
10 grouped by concept.  The list includes each symbol's message (on the
11 @code{error-message} property of the symbol), and a cross reference to a
12 description of how the error can occur.
14   Each error symbol has an @code{error-conditions} property which is a
15 list of symbols.  Normally, this list includes the error symbol itself,
16 and the symbol @code{error}.  Occasionally it includes additional
17 symbols, which are intermediate classifications, narrower than @code{error}
18 but broader than a single error symbol.  For example, all the errors
19 in accessing files have the condition @code{file-error}.
21   As a special exception, the error symbol @code{quit} does not have the
22 condition @code{error}, because quitting is not considered an error.
24   @xref{Errors}, for an explanation of how errors are generated and
25 handled.
27 @table @code
28 @item @var{symbol}
29 @var{string}; @var{reference}.
31 @item error
32 @code{"error"}@*
33 @xref{Errors}.
35 @item quit
36 @code{"Quit"}@*
37 @xref{Quitting}.
39 @item args-out-of-range
40 @code{"Args out of range"}@*
41 @xref{Sequences Arrays Vectors}.
43 @item arith-error
44 @code{"Arithmetic error"}@*
45 See @code{/} and @code{%} in @ref{Numbers}.
47 @item beginning-of-buffer
48 @code{"Beginning of buffer"}@*
49 @xref{Motion}.
51 @item buffer-read-only
52 @code{"Buffer is read-only"}@*
53 @xref{Read Only Buffers}.
55 @item end-of-buffer
56 @code{"End of buffer"}@*
57 @xref{Motion}.
59 @item end-of-file
60 @code{"End of file during parsing"}@*
61 This is not a @code{file-error}.@*
62 @xref{Input Functions}.
64 @item file-error
65 This error, and its subcategories, do not have
66 error-strings, because the error message is constructed from the data
67 items alone when the error condition @code{file-error} is present.@*
68 @xref{Files}.
70 @item file-locked     
71 This is a @code{file-error}.@*
72 @xref{File Locks}.
74 @item file-already-exists
75 This is a @code{file-error}.@*
76 @xref{Writing to Files}.
78 @item file-supersession
79 This is a @code{file-error}.@*
80 @xref{Buffer Modification}.
82 @item invalid-function
83 @code{"Invalid function"}@*
84 @xref{Classifying Lists}.
86 @item invalid-read-syntax
87 @code{"Invalid read syntax"}@*
88 @xref{Input Functions}.
90 @item invalid-regexp
91 @code{"Invalid regexp"}@*
92 @xref{Regular Expressions}.
94 @item no-catch
95 @code{"No catch for tag"}@*
96 @xref{Catch and Throw}.
98 @item search-failed
99 @code{"Search failed"}@*
100 @xref{Searching and Matching}.
102 @item setting-constant
103 @code{"Attempt to set a constant symbol"}@* 
104 The values of the symbols @code{nil} and @code{t}
105 may not be changed.@*
106 @xref{Constant Variables, , Variables that Never Change}.
108 @item void-function
109 @code{"Symbol's function definition is void"}@*
110 @xref{Function Cells}.
112 @item void-variable
113 @code{"Symbol's value as variable is void"}@*
114 @xref{Accessing Variables}.
116 @item wrong-number-of-arguments
117 @code{"Wrong number of arguments"}@*
118 @xref{Classifying Lists}.
120 @item wrong-type-argument
121 @code{"Wrong type argument"}@*
122 @xref{Type Predicates}.
123 @end table