Commit | Line | Data |
---|---|---|
5320ab51 RS |
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 | |
8 | ||
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 | |
5632e6b4 | 11 | @code{error-message} property of the symbol) and a cross reference to a |
5320ab51 RS |
12 | description of how the error can occur. |
13 | ||
5632e6b4 RS |
14 | Each error symbol has an @code{error-conditions} property that is a |
15 | list of symbols. Normally this list includes the error symbol itself | |
5320ab51 | 16 | and the symbol @code{error}. Occasionally it includes additional |
5632e6b4 RS |
17 | symbols, which are intermediate classifications, narrower than |
18 | @code{error} but broader than a single error symbol. For example, all | |
f9f59935 RS |
19 | the errors in accessing files have the condition @code{file-error}. If |
20 | we do not say here that a certain error symbol has additional error | |
21 | conditions, that means it has none. | |
5320ab51 RS |
22 | |
23 | As a special exception, the error symbol @code{quit} does not have the | |
24 | condition @code{error}, because quitting is not considered an error. | |
25 | ||
26 | @xref{Errors}, for an explanation of how errors are generated and | |
27 | handled. | |
28 | ||
29 | @table @code | |
30 | @item @var{symbol} | |
31 | @var{string}; @var{reference}. | |
32 | ||
33 | @item error | |
34 | @code{"error"}@* | |
35 | @xref{Errors}. | |
36 | ||
37 | @item quit | |
38 | @code{"Quit"}@* | |
39 | @xref{Quitting}. | |
40 | ||
41 | @item args-out-of-range | |
42 | @code{"Args out of range"}@* | |
43 | @xref{Sequences Arrays Vectors}. | |
44 | ||
45 | @item arith-error | |
46 | @code{"Arithmetic error"}@* | |
47 | See @code{/} and @code{%} in @ref{Numbers}. | |
48 | ||
49 | @item beginning-of-buffer | |
50 | @code{"Beginning of buffer"}@* | |
51 | @xref{Motion}. | |
52 | ||
53 | @item buffer-read-only | |
54 | @code{"Buffer is read-only"}@* | |
55 | @xref{Read Only Buffers}. | |
56 | ||
bfe721d1 | 57 | @item cyclic-function-indirection |
ebc6903b | 58 | @code{"Symbol's chain of function indirections\@* contains a loop"}@* |
bfe721d1 KH |
59 | @xref{Function Indirection}. |
60 | ||
5320ab51 RS |
61 | @item end-of-buffer |
62 | @code{"End of buffer"}@* | |
63 | @xref{Motion}. | |
64 | ||
65 | @item end-of-file | |
66 | @code{"End of file during parsing"}@* | |
8241495d | 67 | Note that this is not a subcategory of @code{file-error}, |
969fe9b5 | 68 | because it pertains to the Lisp reader, not to file I/O. |
5320ab51 RS |
69 | @xref{Input Functions}. |
70 | ||
969fe9b5 | 71 | @item file-already-exists |
8241495d | 72 | This is a subcategory of @code{file-error}.@* |
969fe9b5 RS |
73 | @xref{Writing to Files}. |
74 | ||
f9f59935 RS |
75 | @item file-date-error |
76 | This is a subcategory of @code{file-error}. It occurs when | |
77 | @code{copy-file} tries and fails to set the last-modification time of | |
78 | the output file. @xref{Changing Files}. | |
79 | ||
5320ab51 | 80 | @item file-error |
5632e6b4 RS |
81 | This error and its subcategories do not have error-strings, because the |
82 | error message is constructed from the data items alone when the error | |
83 | condition @code{file-error} is present.@* | |
5320ab51 RS |
84 | @xref{Files}. |
85 | ||
86 | @item file-locked | |
8241495d | 87 | This is a subcategory of @code{file-error}.@* |
5320ab51 RS |
88 | @xref{File Locks}. |
89 | ||
5320ab51 | 90 | @item file-supersession |
8241495d | 91 | This is a subcategory of @code{file-error}.@* |
5632e6b4 | 92 | @xref{Modification Time}. |
5320ab51 RS |
93 | |
94 | @item invalid-function | |
95 | @code{"Invalid function"}@* | |
96 | @xref{Classifying Lists}. | |
97 | ||
98 | @item invalid-read-syntax | |
99 | @code{"Invalid read syntax"}@* | |
100 | @xref{Input Functions}. | |
101 | ||
102 | @item invalid-regexp | |
103 | @code{"Invalid regexp"}@* | |
104 | @xref{Regular Expressions}. | |
105 | ||
969fe9b5 | 106 | @item mark-inactive |
a9f0a989 | 107 | @code{"Mark inactive"}@* |
969fe9b5 RS |
108 | @xref{The Mark}. |
109 | ||
5320ab51 RS |
110 | @item no-catch |
111 | @code{"No catch for tag"}@* | |
112 | @xref{Catch and Throw}. | |
113 | ||
969fe9b5 RS |
114 | @item scan-error |
115 | @code{"Scan error"}@* | |
116 | This happens when certain syntax-parsing functions | |
117 | find invalid syntax or mismatched parentheses.@* | |
118 | @xref{List Motion}, and @ref{Parsing Expressions}. | |
119 | ||
5320ab51 RS |
120 | @item search-failed |
121 | @code{"Search failed"}@* | |
122 | @xref{Searching and Matching}. | |
123 | ||
124 | @item setting-constant | |
125 | @code{"Attempt to set a constant symbol"}@* | |
969fe9b5 RS |
126 | The values of the symbols @code{nil} and @code{t}, |
127 | and any symbols that start with @samp{:}, | |
5320ab51 RS |
128 | may not be changed.@* |
129 | @xref{Constant Variables, , Variables that Never Change}. | |
130 | ||
bfe721d1 KH |
131 | @item undefined-color |
132 | @code{"Undefined color"}@* | |
133 | @xref{Color Names}. | |
134 | ||
5320ab51 RS |
135 | @item void-function |
136 | @code{"Symbol's function definition is void"}@* | |
137 | @xref{Function Cells}. | |
138 | ||
139 | @item void-variable | |
140 | @code{"Symbol's value as variable is void"}@* | |
141 | @xref{Accessing Variables}. | |
142 | ||
143 | @item wrong-number-of-arguments | |
144 | @code{"Wrong number of arguments"}@* | |
145 | @xref{Classifying Lists}. | |
146 | ||
147 | @item wrong-type-argument | |
148 | @code{"Wrong type argument"}@* | |
149 | @xref{Type Predicates}. | |
bfe721d1 KH |
150 | @end table |
151 | ||
969fe9b5 | 152 | These kinds of error, which are classified as special cases of |
bfe721d1 KH |
153 | @code{arith-error}, can occur on certain systems for invalid use of |
154 | mathematical functions. | |
155 | ||
156 | @table @code | |
157 | @item domain-error | |
158 | @code{"Arithmetic domain error"}@* | |
159 | @xref{Math Functions}. | |
160 | ||
161 | @item overflow-error | |
162 | @code{"Arithmetic overflow error"}@* | |
163 | @xref{Math Functions}. | |
164 | ||
165 | @item range-error | |
166 | @code{"Arithmetic range error"}@* | |
167 | @xref{Math Functions}. | |
168 | ||
169 | @item singularity-error | |
170 | @code{"Arithmetic singularity error"}@* | |
171 | @xref{Math Functions}. | |
172 | ||
173 | @item underflow-error | |
174 | @code{"Arithmetic underflow error"}@* | |
175 | @xref{Math Functions}. | |
5320ab51 | 176 | @end table |