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