Mercurial > emacs
annotate lispref/errors.texi @ 47347:28bab21524d4
(Fdiscard_input): If defining keyboard macro,
end and save it instead of discarding it.
author | Kim F. Storm <storm@cua.dk> |
---|---|
date | Mon, 09 Sep 2002 22:33:36 +0000 |
parents | 9f3e1a8c8870 |
children | 23a1cea22d13 |
rev | line source |
---|---|
2899 | 1 @c -*-texinfo-*- |
2 @c This is part of the GNU Emacs Lisp Reference Manual. | |
27189 | 3 @c Copyright (C) 1990, 1991, 1992, 1993, 1999 Free Software Foundation, Inc. |
2899 | 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 | |
8 | |
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 | |
7600 | 11 @code{error-message} property of the symbol) and a cross reference to a |
2899 | 12 description of how the error can occur. |
13 | |
7600 | 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 | |
2899 | 16 and the symbol @code{error}. Occasionally it includes additional |
7600 | 17 symbols, which are intermediate classifications, narrower than |
18 @code{error} but broader than a single error symbol. For example, all | |
21007
66d807bdc5b4
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
16736
diff
changeset
|
19 the errors in accessing files have the condition @code{file-error}. If |
66d807bdc5b4
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
16736
diff
changeset
|
20 we do not say here that a certain error symbol has additional error |
66d807bdc5b4
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
16736
diff
changeset
|
21 conditions, that means it has none. |
2899 | 22 |
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. | |
25 | |
26 @xref{Errors}, for an explanation of how errors are generated and | |
27 handled. | |
28 | |
29 @table @code | |
30 @item @var{symbol} | |
31 @var{string}; @var{reference}. | |
32 | |
33 @item error | |
34 @code{"error"}@* | |
35 @xref{Errors}. | |
36 | |
37 @item quit | |
38 @code{"Quit"}@* | |
39 @xref{Quitting}. | |
40 | |
41 @item args-out-of-range | |
42 @code{"Args out of range"}@* | |
43 @xref{Sequences Arrays Vectors}. | |
44 | |
45 @item arith-error | |
46 @code{"Arithmetic error"}@* | |
47 See @code{/} and @code{%} in @ref{Numbers}. | |
48 | |
49 @item beginning-of-buffer | |
50 @code{"Beginning of buffer"}@* | |
51 @xref{Motion}. | |
52 | |
53 @item buffer-read-only | |
54 @code{"Buffer is read-only"}@* | |
55 @xref{Read Only Buffers}. | |
56 | |
26288 | 57 @item coding-system-error |
58 @code{"Invalid coding system"}@* | |
59 @xref{Coding Systems}. | |
60 | |
12098 | 61 @item cyclic-function-indirection |
22267
dfac7398266b
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
22252
diff
changeset
|
62 @code{"Symbol's chain of function indirections\@* contains a loop"}@* |
12098 | 63 @xref{Function Indirection}. |
64 | |
2899 | 65 @item end-of-buffer |
66 @code{"End of buffer"}@* | |
67 @xref{Motion}. | |
68 | |
69 @item end-of-file | |
70 @code{"End of file during parsing"}@* | |
25751
467b88fab665
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
22267
diff
changeset
|
71 Note that this is not a subcategory of @code{file-error}, |
21682
90da2489c498
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
21007
diff
changeset
|
72 because it pertains to the Lisp reader, not to file I/O. |
2899 | 73 @xref{Input Functions}. |
74 | |
21682
90da2489c498
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
21007
diff
changeset
|
75 @item file-already-exists |
25751
467b88fab665
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
22267
diff
changeset
|
76 This is a subcategory of @code{file-error}.@* |
21682
90da2489c498
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
21007
diff
changeset
|
77 @xref{Writing to Files}. |
90da2489c498
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
21007
diff
changeset
|
78 |
21007
66d807bdc5b4
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
16736
diff
changeset
|
79 @item file-date-error |
66d807bdc5b4
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
16736
diff
changeset
|
80 This is a subcategory of @code{file-error}. It occurs when |
66d807bdc5b4
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
16736
diff
changeset
|
81 @code{copy-file} tries and fails to set the last-modification time of |
66d807bdc5b4
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
16736
diff
changeset
|
82 the output file. @xref{Changing Files}. |
66d807bdc5b4
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
16736
diff
changeset
|
83 |
2899 | 84 @item file-error |
7600 | 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.@* | |
2899 | 88 @xref{Files}. |
89 | |
90 @item file-locked | |
25751
467b88fab665
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
22267
diff
changeset
|
91 This is a subcategory of @code{file-error}.@* |
2899 | 92 @xref{File Locks}. |
93 | |
94 @item file-supersession | |
25751
467b88fab665
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
22267
diff
changeset
|
95 This is a subcategory of @code{file-error}.@* |
7600 | 96 @xref{Modification Time}. |
2899 | 97 |
26288 | 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.@* | |
38581 | 101 @xref{Remote Files,,, emacs, The GNU Emacs Manual}. |
26288 | 102 |
2899 | 103 @item invalid-function |
104 @code{"Invalid function"}@* | |
105 @xref{Classifying Lists}. | |
106 | |
107 @item invalid-read-syntax | |
108 @code{"Invalid read syntax"}@* | |
109 @xref{Input Functions}. | |
110 | |
111 @item invalid-regexp | |
112 @code{"Invalid regexp"}@* | |
113 @xref{Regular Expressions}. | |
114 | |
21682
90da2489c498
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
21007
diff
changeset
|
115 @item mark-inactive |
22138
d4ac295a98b3
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
21682
diff
changeset
|
116 @code{"Mark inactive"}@* |
21682
90da2489c498
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
21007
diff
changeset
|
117 @xref{The Mark}. |
90da2489c498
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
21007
diff
changeset
|
118 |
2899 | 119 @item no-catch |
120 @code{"No catch for tag"}@* | |
121 @xref{Catch and Throw}. | |
122 | |
21682
90da2489c498
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
21007
diff
changeset
|
123 @item scan-error |
90da2489c498
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
21007
diff
changeset
|
124 @code{"Scan error"}@* |
90da2489c498
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
21007
diff
changeset
|
125 This happens when certain syntax-parsing functions |
90da2489c498
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
21007
diff
changeset
|
126 find invalid syntax or mismatched parentheses.@* |
90da2489c498
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
21007
diff
changeset
|
127 @xref{List Motion}, and @ref{Parsing Expressions}. |
90da2489c498
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
21007
diff
changeset
|
128 |
2899 | 129 @item search-failed |
130 @code{"Search failed"}@* | |
131 @xref{Searching and Matching}. | |
132 | |
133 @item setting-constant | |
134 @code{"Attempt to set a constant symbol"}@* | |
21682
90da2489c498
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
21007
diff
changeset
|
135 The values of the symbols @code{nil} and @code{t}, |
90da2489c498
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
21007
diff
changeset
|
136 and any symbols that start with @samp{:}, |
2899 | 137 may not be changed.@* |
138 @xref{Constant Variables, , Variables that Never Change}. | |
139 | |
26288 | 140 @item text-read-only |
141 @code{"Text is read-only"}@* | |
142 @xref{Special Properties}. | |
143 | |
12098 | 144 @item undefined-color |
145 @code{"Undefined color"}@* | |
146 @xref{Color Names}. | |
147 | |
2899 | 148 @item void-function |
149 @code{"Symbol's function definition is void"}@* | |
150 @xref{Function Cells}. | |
151 | |
152 @item void-variable | |
153 @code{"Symbol's value as variable is void"}@* | |
154 @xref{Accessing Variables}. | |
155 | |
156 @item wrong-number-of-arguments | |
157 @code{"Wrong number of arguments"}@* | |
158 @xref{Classifying Lists}. | |
159 | |
160 @item wrong-type-argument | |
161 @code{"Wrong type argument"}@* | |
162 @xref{Type Predicates}. | |
163 @end table | |
12098 | 164 |
21682
90da2489c498
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
21007
diff
changeset
|
165 These kinds of error, which are classified as special cases of |
12098 | 166 @code{arith-error}, can occur on certain systems for invalid use of |
167 mathematical functions. | |
168 | |
169 @table @code | |
170 @item domain-error | |
171 @code{"Arithmetic domain error"}@* | |
172 @xref{Math Functions}. | |
173 | |
174 @item overflow-error | |
175 @code{"Arithmetic overflow error"}@* | |
176 @xref{Math Functions}. | |
177 | |
178 @item range-error | |
179 @code{"Arithmetic range error"}@* | |
180 @xref{Math Functions}. | |
181 | |
182 @item singularity-error | |
183 @code{"Arithmetic singularity error"}@* | |
184 @xref{Math Functions}. | |
185 | |
186 @item underflow-error | |
187 @code{"Arithmetic underflow error"}@* | |
188 @xref{Math Functions}. | |
189 @end table |