Commit | Line | Data |
---|---|---|
5320ab51 RS |
1 | @c -*-texinfo-*- |
2 | @c This is part of the GNU Emacs Lisp Reference Manual. | |
651f374c | 3 | @c Copyright (C) 1990, 1991, 1992, 1993, 1999, 2002, 2003, 2004, |
ceb4c4d3 | 4 | @c 2005, 2006 Free Software Foundation, Inc. |
5320ab51 RS |
5 | @c See the file elisp.texi for copying conditions. |
6 | @setfilename ../info/errors | |
7 | @node Standard Errors, Standard Buffer-Local Variables, GNU Emacs Internals, Top | |
8 | @appendix Standard Errors | |
9 | ||
10 | Here is the complete list of the error symbols in standard Emacs, | |
11 | grouped by concept. The list includes each symbol's message (on the | |
5632e6b4 | 12 | @code{error-message} property of the symbol) and a cross reference to a |
5320ab51 RS |
13 | description of how the error can occur. |
14 | ||
5632e6b4 RS |
15 | Each error symbol has an @code{error-conditions} property that is a |
16 | list of symbols. Normally this list includes the error symbol itself | |
5320ab51 | 17 | and the symbol @code{error}. Occasionally it includes additional |
5632e6b4 RS |
18 | symbols, which are intermediate classifications, narrower than |
19 | @code{error} but broader than a single error symbol. For example, all | |
f9f59935 RS |
20 | the errors in accessing files have the condition @code{file-error}. If |
21 | we do not say here that a certain error symbol has additional error | |
22 | conditions, that means it has none. | |
5320ab51 RS |
23 | |
24 | As a special exception, the error symbol @code{quit} does not have the | |
25 | condition @code{error}, because quitting is not considered an error. | |
26 | ||
27 | @xref{Errors}, for an explanation of how errors are generated and | |
28 | handled. | |
29 | ||
30 | @table @code | |
31 | @item @var{symbol} | |
32 | @var{string}; @var{reference}. | |
33 | ||
34 | @item error | |
35 | @code{"error"}@* | |
36 | @xref{Errors}. | |
37 | ||
38 | @item quit | |
39 | @code{"Quit"}@* | |
40 | @xref{Quitting}. | |
41 | ||
42 | @item args-out-of-range | |
43 | @code{"Args out of range"}@* | |
63182706 CY |
44 | This happens when trying to access an element beyond the range of a |
45 | sequence or buffer.@* | |
46 | @xref{Sequences Arrays Vectors}, @xref{Text}. | |
5320ab51 RS |
47 | |
48 | @item arith-error | |
49 | @code{"Arithmetic error"}@* | |
63182706 | 50 | @xref{Arithmetic Operations}. |
5320ab51 RS |
51 | |
52 | @item beginning-of-buffer | |
53 | @code{"Beginning of buffer"}@* | |
63182706 | 54 | @xref{Character Motion}. |
5320ab51 RS |
55 | |
56 | @item buffer-read-only | |
57 | @code{"Buffer is read-only"}@* | |
58 | @xref{Read Only Buffers}. | |
59 | ||
79ddc9c9 GM |
60 | @item coding-system-error |
61 | @code{"Invalid coding system"}@* | |
63182706 | 62 | @xref{Lisp and Coding Systems}. |
79ddc9c9 | 63 | |
bfe721d1 | 64 | @item cyclic-function-indirection |
ebc6903b | 65 | @code{"Symbol's chain of function indirections\@* contains a loop"}@* |
bfe721d1 KH |
66 | @xref{Function Indirection}. |
67 | ||
571fd4d5 | 68 | @item cyclic-variable-indirection |
342fd6cd | 69 | @code{"Symbol's chain of variable indirections\@* contains a loop"}@* |
571fd4d5 JH |
70 | @xref{Variable Aliases}. |
71 | ||
5320ab51 RS |
72 | @item end-of-buffer |
73 | @code{"End of buffer"}@* | |
63182706 | 74 | @xref{Character Motion}. |
5320ab51 RS |
75 | |
76 | @item end-of-file | |
77 | @code{"End of file during parsing"}@* | |
8241495d | 78 | Note that this is not a subcategory of @code{file-error}, |
c1bbeff0 | 79 | because it pertains to the Lisp reader, not to file I/O.@* |
5320ab51 RS |
80 | @xref{Input Functions}. |
81 | ||
969fe9b5 | 82 | @item file-already-exists |
8241495d | 83 | This is a subcategory of @code{file-error}.@* |
969fe9b5 RS |
84 | @xref{Writing to Files}. |
85 | ||
f9f59935 RS |
86 | @item file-date-error |
87 | This is a subcategory of @code{file-error}. It occurs when | |
88 | @code{copy-file} tries and fails to set the last-modification time of | |
c1bbeff0 LT |
89 | the output file.@* |
90 | @xref{Changing Files}. | |
f9f59935 | 91 | |
5320ab51 | 92 | @item file-error |
c1bbeff0 LT |
93 | We do not list the error-strings of this error and its subcategories, |
94 | because the error message is normally constructed from the data items | |
95 | alone when the error condition @code{file-error} is present. Thus, | |
96 | the error-strings are not very relevant. However, these error symbols | |
97 | do have @code{error-message} properties, and if no data is provided, | |
98 | the @code{error-message} property @emph{is} used.@* | |
5320ab51 RS |
99 | @xref{Files}. |
100 | ||
177c0ea7 | 101 | @item file-locked |
8241495d | 102 | This is a subcategory of @code{file-error}.@* |
5320ab51 RS |
103 | @xref{File Locks}. |
104 | ||
5320ab51 | 105 | @item file-supersession |
8241495d | 106 | This is a subcategory of @code{file-error}.@* |
5632e6b4 | 107 | @xref{Modification Time}. |
5320ab51 | 108 | |
79ddc9c9 GM |
109 | @item ftp-error |
110 | This is a subcategory of @code{file-error}, which results from problems | |
111 | in accessing a remote file using ftp.@* | |
0b2fb045 | 112 | @xref{Remote Files,,, emacs, The GNU Emacs Manual}. |
79ddc9c9 | 113 | |
5320ab51 RS |
114 | @item invalid-function |
115 | @code{"Invalid function"}@* | |
63182706 | 116 | @xref{Function Indirection}. |
5320ab51 RS |
117 | |
118 | @item invalid-read-syntax | |
119 | @code{"Invalid read syntax"}@* | |
63182706 | 120 | @xref{Printed Representation}. |
5320ab51 RS |
121 | |
122 | @item invalid-regexp | |
123 | @code{"Invalid regexp"}@* | |
124 | @xref{Regular Expressions}. | |
125 | ||
969fe9b5 | 126 | @item mark-inactive |
c1bbeff0 | 127 | @code{"The mark is not active now"}@* |
969fe9b5 RS |
128 | @xref{The Mark}. |
129 | ||
5320ab51 RS |
130 | @item no-catch |
131 | @code{"No catch for tag"}@* | |
132 | @xref{Catch and Throw}. | |
133 | ||
969fe9b5 RS |
134 | @item scan-error |
135 | @code{"Scan error"}@* | |
136 | This happens when certain syntax-parsing functions | |
137 | find invalid syntax or mismatched parentheses.@* | |
138 | @xref{List Motion}, and @ref{Parsing Expressions}. | |
139 | ||
5320ab51 RS |
140 | @item search-failed |
141 | @code{"Search failed"}@* | |
142 | @xref{Searching and Matching}. | |
143 | ||
144 | @item setting-constant | |
177c0ea7 | 145 | @code{"Attempt to set a constant symbol"}@* |
969fe9b5 RS |
146 | The values of the symbols @code{nil} and @code{t}, |
147 | and any symbols that start with @samp{:}, | |
5320ab51 RS |
148 | may not be changed.@* |
149 | @xref{Constant Variables, , Variables that Never Change}. | |
150 | ||
79ddc9c9 GM |
151 | @item text-read-only |
152 | @code{"Text is read-only"}@* | |
c1bbeff0 | 153 | This is a subcategory of @code{buffer-read-only}.@* |
79ddc9c9 GM |
154 | @xref{Special Properties}. |
155 | ||
bfe721d1 KH |
156 | @item undefined-color |
157 | @code{"Undefined color"}@* | |
158 | @xref{Color Names}. | |
159 | ||
5320ab51 RS |
160 | @item void-function |
161 | @code{"Symbol's function definition is void"}@* | |
162 | @xref{Function Cells}. | |
163 | ||
164 | @item void-variable | |
165 | @code{"Symbol's value as variable is void"}@* | |
166 | @xref{Accessing Variables}. | |
167 | ||
168 | @item wrong-number-of-arguments | |
169 | @code{"Wrong number of arguments"}@* | |
170 | @xref{Classifying Lists}. | |
171 | ||
172 | @item wrong-type-argument | |
173 | @code{"Wrong type argument"}@* | |
174 | @xref{Type Predicates}. | |
bfe721d1 KH |
175 | @end table |
176 | ||
969fe9b5 | 177 | These kinds of error, which are classified as special cases of |
bfe721d1 KH |
178 | @code{arith-error}, can occur on certain systems for invalid use of |
179 | mathematical functions. | |
180 | ||
181 | @table @code | |
182 | @item domain-error | |
183 | @code{"Arithmetic domain error"}@* | |
184 | @xref{Math Functions}. | |
185 | ||
186 | @item overflow-error | |
187 | @code{"Arithmetic overflow error"}@* | |
c1bbeff0 | 188 | This is a subcategory of @code{domain-error}.@* |
bfe721d1 KH |
189 | @xref{Math Functions}. |
190 | ||
191 | @item range-error | |
192 | @code{"Arithmetic range error"}@* | |
193 | @xref{Math Functions}. | |
194 | ||
195 | @item singularity-error | |
196 | @code{"Arithmetic singularity error"}@* | |
c1bbeff0 | 197 | This is a subcategory of @code{domain-error}.@* |
bfe721d1 KH |
198 | @xref{Math Functions}. |
199 | ||
200 | @item underflow-error | |
201 | @code{"Arithmetic underflow error"}@* | |
c1bbeff0 | 202 | This is a subcategory of @code{domain-error}.@* |
bfe721d1 | 203 | @xref{Math Functions}. |
5320ab51 | 204 | @end table |
ab5796a9 MB |
205 | |
206 | @ignore | |
207 | arch-tag: 717c6048-5d9d-4c7d-9a62-df57390b6f19 | |
208 | @end ignore |