*** empty log message ***
[emacs.git] / lispref / errors.texi
blob2463c4c6ef5af23b65cd29de2d17abcdcfcdf03e
1 @c -*-texinfo-*-
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
27 handled.
29 @table @code
30 @item @var{symbol}
31 @var{string}; @var{reference}.
33 @item error
34 @code{"error"}@*
35 @xref{Errors}.
37 @item quit
38 @code{"Quit"}@*
39 @xref{Quitting}.
41 @item args-out-of-range
42 @code{"Args out of range"}@*
43 @xref{Sequences Arrays Vectors}.
45 @item arith-error
46 @code{"Arithmetic error"}@*
47 See @code{/} and @code{%} in @ref{Numbers}.
49 @item beginning-of-buffer
50 @code{"Beginning of buffer"}@*
51 @xref{Motion}.
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}.
65 @item end-of-buffer
66 @code{"End of buffer"}@*
67 @xref{Motion}.
69 @item end-of-file
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}.
79 @item file-date-error
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
82 the output file.  @xref{Changing Files}.
84 @item file-error
85 This error and its subcategories do not have error-strings, because the
86 error message is constructed from the data items alone when the error
87 condition @code{file-error} is present.@*
88 @xref{Files}.
90 @item file-locked     
91 This is a subcategory of @code{file-error}.@*
92 @xref{File Locks}.
94 @item file-supersession
95 This is a subcategory of @code{file-error}.@*
96 @xref{Modification Time}.
98 @item ftp-error
99 This is a subcategory of @code{file-error}, which results from problems
100 in accessing a remote file using ftp.@*
101 @xref{Remote Files,,, emacs, The Emacs Manual}.
103 @item invalid-function
104 @code{"Invalid function"}@*
105 @xref{Classifying Lists}.
107 @item invalid-read-syntax
108 @code{"Invalid read syntax"}@*
109 @xref{Input Functions}.
111 @item invalid-regexp
112 @code{"Invalid regexp"}@*
113 @xref{Regular Expressions}.
115 @item mark-inactive
116 @code{"Mark inactive"}@*
117 @xref{The Mark}.
119 @item no-catch
120 @code{"No catch for tag"}@*
121 @xref{Catch and Throw}.
123 @item scan-error
124 @code{"Scan error"}@*
125 This happens when certain syntax-parsing functions
126 find invalid syntax or mismatched parentheses.@*
127 @xref{List Motion}, and @ref{Parsing Expressions}.
129 @item search-failed
130 @code{"Search failed"}@*
131 @xref{Searching and Matching}.
133 @item setting-constant
134 @code{"Attempt to set a constant symbol"}@* 
135 The values of the symbols @code{nil} and @code{t},
136 and any symbols that start with @samp{:},
137 may not be changed.@*
138 @xref{Constant Variables, , Variables that Never Change}.
140 @item text-read-only
141 @code{"Text is read-only"}@*
142 @xref{Special Properties}.
144 @item undefined-color
145 @code{"Undefined color"}@*
146 @xref{Color Names}.
148 @item void-function
149 @code{"Symbol's function definition is void"}@*
150 @xref{Function Cells}.
152 @item void-variable
153 @code{"Symbol's value as variable is void"}@*
154 @xref{Accessing Variables}.
156 @item wrong-number-of-arguments
157 @code{"Wrong number of arguments"}@*
158 @xref{Classifying Lists}.
160 @item wrong-type-argument
161 @code{"Wrong type argument"}@*
162 @xref{Type Predicates}.
163 @end table
165   These kinds of error, which are classified as special cases of
166 @code{arith-error}, can occur on certain systems for invalid use of
167 mathematical functions.
169 @table @code
170 @item domain-error
171 @code{"Arithmetic domain error"}@*
172 @xref{Math Functions}.
174 @item overflow-error
175 @code{"Arithmetic overflow error"}@*
176 @xref{Math Functions}.
178 @item range-error
179 @code{"Arithmetic range error"}@*
180 @xref{Math Functions}.
182 @item singularity-error
183 @code{"Arithmetic singularity error"}@*
184 @xref{Math Functions}.
186 @item underflow-error
187 @code{"Arithmetic underflow error"}@*
188 @xref{Math Functions}.
189 @end table