2 @c This is part of the GNU Emacs Lisp Reference Manual.
3 @c Copyright (C) 1990, 1991, 1992, 1993, 1999, 2002, 2003, 2004,
4 @c 2005 Free Software Foundation, Inc.
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
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
12 @code{error-message} property of the symbol) and a cross reference to a
13 description of how the error can occur.
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
17 and the symbol @code{error}. Occasionally it includes additional
18 symbols, which are intermediate classifications, narrower than
19 @code{error} but broader than a single error symbol. For example, all
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.
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.
27 @xref{Errors}, for an explanation of how errors are generated and
32 @var{string}; @var{reference}.
42 @item args-out-of-range
43 @code{"Args out of range"}@*
44 @xref{Sequences Arrays Vectors}.
47 @code{"Arithmetic error"}@*
48 See @code{/} and @code{%} in @ref{Numbers}.
50 @item beginning-of-buffer
51 @code{"Beginning of buffer"}@*
54 @item buffer-read-only
55 @code{"Buffer is read-only"}@*
56 @xref{Read Only Buffers}.
58 @item coding-system-error
59 @code{"Invalid coding system"}@*
60 @xref{Coding Systems}.
62 @item cyclic-function-indirection
63 @code{"Symbol's chain of function indirections\@* contains a loop"}@*
64 @xref{Function Indirection}.
66 @item cyclic-variable-indirection
67 @code{"Symbol's chain of variable indirections\@* contains a loop"}@*
68 @xref{Variable Aliases}.
71 @code{"End of buffer"}@*
75 @code{"End of file during parsing"}@*
76 Note that this is not a subcategory of @code{file-error},
77 because it pertains to the Lisp reader, not to file I/O.@*
78 @xref{Input Functions}.
80 @item file-already-exists
81 This is a subcategory of @code{file-error}.@*
82 @xref{Writing to Files}.
85 This is a subcategory of @code{file-error}. It occurs when
86 @code{copy-file} tries and fails to set the last-modification time of
88 @xref{Changing Files}.
91 We do not list the error-strings of this error and its subcategories,
92 because the error message is normally constructed from the data items
93 alone when the error condition @code{file-error} is present. Thus,
94 the error-strings are not very relevant. However, these error symbols
95 do have @code{error-message} properties, and if no data is provided,
96 the @code{error-message} property @emph{is} used.@*
100 This is a subcategory of @code{file-error}.@*
103 @item file-supersession
104 This is a subcategory of @code{file-error}.@*
105 @xref{Modification Time}.
108 This is a subcategory of @code{file-error}, which results from problems
109 in accessing a remote file using ftp.@*
110 @xref{Remote Files,,, emacs, The GNU Emacs Manual}.
112 @item invalid-function
113 @code{"Invalid function"}@*
114 @xref{Classifying Lists}.
116 @item invalid-read-syntax
117 @code{"Invalid read syntax"}@*
118 @xref{Input Functions}.
121 @code{"Invalid regexp"}@*
122 @xref{Regular Expressions}.
125 @code{"The mark is not active now"}@*
129 @code{"No catch for tag"}@*
130 @xref{Catch and Throw}.
133 @code{"Scan error"}@*
134 This happens when certain syntax-parsing functions
135 find invalid syntax or mismatched parentheses.@*
136 @xref{List Motion}, and @ref{Parsing Expressions}.
139 @code{"Search failed"}@*
140 @xref{Searching and Matching}.
142 @item setting-constant
143 @code{"Attempt to set a constant symbol"}@*
144 The values of the symbols @code{nil} and @code{t},
145 and any symbols that start with @samp{:},
146 may not be changed.@*
147 @xref{Constant Variables, , Variables that Never Change}.
150 @code{"Text is read-only"}@*
151 This is a subcategory of @code{buffer-read-only}.@*
152 @xref{Special Properties}.
154 @item undefined-color
155 @code{"Undefined color"}@*
159 @code{"Symbol's function definition is void"}@*
160 @xref{Function Cells}.
163 @code{"Symbol's value as variable is void"}@*
164 @xref{Accessing Variables}.
166 @item wrong-number-of-arguments
167 @code{"Wrong number of arguments"}@*
168 @xref{Classifying Lists}.
170 @item wrong-type-argument
171 @code{"Wrong type argument"}@*
172 @xref{Type Predicates}.
175 These kinds of error, which are classified as special cases of
176 @code{arith-error}, can occur on certain systems for invalid use of
177 mathematical functions.
181 @code{"Arithmetic domain error"}@*
182 @xref{Math Functions}.
185 @code{"Arithmetic overflow error"}@*
186 This is a subcategory of @code{domain-error}.@*
187 @xref{Math Functions}.
190 @code{"Arithmetic range error"}@*
191 @xref{Math Functions}.
193 @item singularity-error
194 @code{"Arithmetic singularity error"}@*
195 This is a subcategory of @code{domain-error}.@*
196 @xref{Math Functions}.
198 @item underflow-error
199 @code{"Arithmetic underflow error"}@*
200 This is a subcategory of @code{domain-error}.@*
201 @xref{Math Functions}.
205 arch-tag: 717c6048-5d9d-4c7d-9a62-df57390b6f19