2 @c This is part of the GNU Emacs Lisp Reference Manual.
3 @c Copyright (C) 1990, 1991, 1992, 1993, 1999 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 that 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
18 @code{error} but broader than a single error symbol. For example, all
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.
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.
26 @xref{Errors}, for an explanation of how errors are generated and
31 @var{string}; @var{reference}.
41 @item args-out-of-range
42 @code{"Args out of range"}@*
43 @xref{Sequences Arrays Vectors}.
46 @code{"Arithmetic error"}@*
47 See @code{/} and @code{%} in @ref{Numbers}.
49 @item beginning-of-buffer
50 @code{"Beginning of buffer"}@*
53 @item buffer-read-only
54 @code{"Buffer is read-only"}@*
55 @xref{Read Only Buffers}.
57 @item coding-system-error
58 @code{"Invalid coding system"}@*
59 @xref{Coding Systems}.
61 @item cyclic-function-indirection
62 @code{"Symbol's chain of function indirections\@* contains a loop"}@*
63 @xref{Function Indirection}.
66 @code{"End of buffer"}@*
70 @code{"End of file during parsing"}@*
71 Note that this is not a subcategory of @code{file-error},
72 because it pertains to the Lisp reader, not to file I/O.@*
73 @xref{Input Functions}.
75 @item file-already-exists
76 This is a subcategory of @code{file-error}.@*
77 @xref{Writing to Files}.
80 This is a subcategory of @code{file-error}. It occurs when
81 @code{copy-file} tries and fails to set the last-modification time of
83 @xref{Changing Files}.
86 We do not list the error-strings of this error and its subcategories,
87 because the error message is normally constructed from the data items
88 alone when the error condition @code{file-error} is present. Thus,
89 the error-strings are not very relevant. However, these error symbols
90 do have @code{error-message} properties, and if no data is provided,
91 the @code{error-message} property @emph{is} used.@*
95 This is a subcategory of @code{file-error}.@*
98 @item file-supersession
99 This is a subcategory of @code{file-error}.@*
100 @xref{Modification Time}.
103 This is a subcategory of @code{file-error}, which results from problems
104 in accessing a remote file using ftp.@*
105 @xref{Remote Files,,, emacs, The GNU Emacs Manual}.
107 @item invalid-function
108 @code{"Invalid function"}@*
109 @xref{Classifying Lists}.
111 @item invalid-read-syntax
112 @code{"Invalid read syntax"}@*
113 @xref{Input Functions}.
116 @code{"Invalid regexp"}@*
117 @xref{Regular Expressions}.
120 @code{"The mark is not active now"}@*
124 @code{"No catch for tag"}@*
125 @xref{Catch and Throw}.
128 @code{"Scan error"}@*
129 This happens when certain syntax-parsing functions
130 find invalid syntax or mismatched parentheses.@*
131 @xref{List Motion}, and @ref{Parsing Expressions}.
134 @code{"Search failed"}@*
135 @xref{Searching and Matching}.
137 @item setting-constant
138 @code{"Attempt to set a constant symbol"}@*
139 The values of the symbols @code{nil} and @code{t},
140 and any symbols that start with @samp{:},
141 may not be changed.@*
142 @xref{Constant Variables, , Variables that Never Change}.
145 @code{"Text is read-only"}@*
146 This is a subcategory of @code{buffer-read-only}.@*
147 @xref{Special Properties}.
149 @item undefined-color
150 @code{"Undefined color"}@*
154 @code{"Symbol's function definition is void"}@*
155 @xref{Function Cells}.
158 @code{"Symbol's value as variable is void"}@*
159 @xref{Accessing Variables}.
161 @item wrong-number-of-arguments
162 @code{"Wrong number of arguments"}@*
163 @xref{Classifying Lists}.
165 @item wrong-type-argument
166 @code{"Wrong type argument"}@*
167 @xref{Type Predicates}.
170 These kinds of error, which are classified as special cases of
171 @code{arith-error}, can occur on certain systems for invalid use of
172 mathematical functions.
176 @code{"Arithmetic domain error"}@*
177 @xref{Math Functions}.
180 @code{"Arithmetic overflow error"}@*
181 This is a subcategory of @code{domain-error}.@*
182 @xref{Math Functions}.
185 @code{"Arithmetic range error"}@*
186 @xref{Math Functions}.
188 @item singularity-error
189 @code{"Arithmetic singularity error"}@*
190 This is a subcategory of @code{domain-error}.@*
191 @xref{Math Functions}.
193 @item underflow-error
194 @code{"Arithmetic underflow error"}@*
195 This is a subcategory of @code{domain-error}.@*
196 @xref{Math Functions}.
200 arch-tag: 717c6048-5d9d-4c7d-9a62-df57390b6f19