Mercurial > emacs
annotate lispref/errors.texi @ 79421:56d25c64546c
*** empty log message ***
author | Juanma Barranquero <lekktu@gmail.com> |
---|---|
date | Thu, 15 Nov 2007 22:13:17 +0000 |
parents | 5e63c4b27767 |
children | a1e16e813aed 4ef881a120fe |
rev | line source |
---|---|
2899 | 1 @c -*-texinfo-*- |
2 @c This is part of the GNU Emacs Lisp Reference Manual. | |
75250
6d19c76d81c5
Update copyright for years from Emacs 21 to present (mainly adding
Glenn Morris <rgm@gnu.org>
parents:
68648
diff
changeset
|
3 @c Copyright (C) 1990, 1991, 1992, 1993, 1999, 2001, 2002, 2003, 2004, |
6d19c76d81c5
Update copyright for years from Emacs 21 to present (mainly adding
Glenn Morris <rgm@gnu.org>
parents:
68648
diff
changeset
|
4 @c 2005, 2006, 2007 Free Software Foundation, Inc. |
2899 | 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 | |
76713
5e63c4b27767
(Standard Errors): Add an index entry.
Eli Zaretskii <eliz@gnu.org>
parents:
75250
diff
changeset
|
9 @cindex standard errors |
2899 | 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 | |
7600 | 13 @code{error-message} property of the symbol) and a cross reference to a |
2899 | 14 description of how the error can occur. |
15 | |
7600 | 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 | |
2899 | 18 and the symbol @code{error}. Occasionally it includes additional |
7600 | 19 symbols, which are intermediate classifications, narrower than |
20 @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
|
21 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
|
22 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
|
23 conditions, that means it has none. |
2899 | 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"}@* | |
65700
fcbeba67c06c
* errors.texi (Standard Errors): Corrected xrefs.
Chong Yidong <cyd@stupidchicken.com>
parents:
64889
diff
changeset
|
45 This happens when trying to access an element beyond the range of a |
fcbeba67c06c
* errors.texi (Standard Errors): Corrected xrefs.
Chong Yidong <cyd@stupidchicken.com>
parents:
64889
diff
changeset
|
46 sequence or buffer.@* |
fcbeba67c06c
* errors.texi (Standard Errors): Corrected xrefs.
Chong Yidong <cyd@stupidchicken.com>
parents:
64889
diff
changeset
|
47 @xref{Sequences Arrays Vectors}, @xref{Text}. |
2899 | 48 |
49 @item arith-error | |
50 @code{"Arithmetic error"}@* | |
65700
fcbeba67c06c
* errors.texi (Standard Errors): Corrected xrefs.
Chong Yidong <cyd@stupidchicken.com>
parents:
64889
diff
changeset
|
51 @xref{Arithmetic Operations}. |
2899 | 52 |
53 @item beginning-of-buffer | |
54 @code{"Beginning of buffer"}@* | |
65700
fcbeba67c06c
* errors.texi (Standard Errors): Corrected xrefs.
Chong Yidong <cyd@stupidchicken.com>
parents:
64889
diff
changeset
|
55 @xref{Character Motion}. |
2899 | 56 |
57 @item buffer-read-only | |
58 @code{"Buffer is read-only"}@* | |
59 @xref{Read Only Buffers}. | |
60 | |
26288 | 61 @item coding-system-error |
62 @code{"Invalid coding system"}@* | |
65700
fcbeba67c06c
* errors.texi (Standard Errors): Corrected xrefs.
Chong Yidong <cyd@stupidchicken.com>
parents:
64889
diff
changeset
|
63 @xref{Lisp and Coding Systems}. |
26288 | 64 |
12098 | 65 @item cyclic-function-indirection |
22267
dfac7398266b
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
22252
diff
changeset
|
66 @code{"Symbol's chain of function indirections\@* contains a loop"}@* |
12098 | 67 @xref{Function Indirection}. |
68 | |
54724
d2c60b264fa8
* variables.texi (Variable Aliases): Mention
Jesper Harder <harder@ifa.au.dk>
parents:
53454
diff
changeset
|
69 @item cyclic-variable-indirection |
63583
99e9892a51d9
Fix formatting ugliness.
Richard M. Stallman <rms@gnu.org>
parents:
54724
diff
changeset
|
70 @code{"Symbol's chain of variable indirections\@* contains a loop"}@* |
54724
d2c60b264fa8
* variables.texi (Variable Aliases): Mention
Jesper Harder <harder@ifa.au.dk>
parents:
53454
diff
changeset
|
71 @xref{Variable Aliases}. |
d2c60b264fa8
* variables.texi (Variable Aliases): Mention
Jesper Harder <harder@ifa.au.dk>
parents:
53454
diff
changeset
|
72 |
2899 | 73 @item end-of-buffer |
74 @code{"End of buffer"}@* | |
65700
fcbeba67c06c
* errors.texi (Standard Errors): Corrected xrefs.
Chong Yidong <cyd@stupidchicken.com>
parents:
64889
diff
changeset
|
75 @xref{Character Motion}. |
2899 | 76 |
77 @item end-of-file | |
78 @code{"End of file during parsing"}@* | |
25751
467b88fab665
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
22267
diff
changeset
|
79 Note that this is not a subcategory of @code{file-error}, |
53454
bedee14106b1
(Standard Errors): Various small corrections and additions.
Luc Teirlinck <teirllm@auburn.edu>
parents:
52401
diff
changeset
|
80 because it pertains to the Lisp reader, not to file I/O.@* |
2899 | 81 @xref{Input Functions}. |
82 | |
21682
90da2489c498
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
21007
diff
changeset
|
83 @item file-already-exists |
25751
467b88fab665
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
22267
diff
changeset
|
84 This is a subcategory of @code{file-error}.@* |
21682
90da2489c498
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
21007
diff
changeset
|
85 @xref{Writing to Files}. |
90da2489c498
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
21007
diff
changeset
|
86 |
21007
66d807bdc5b4
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
16736
diff
changeset
|
87 @item file-date-error |
66d807bdc5b4
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
16736
diff
changeset
|
88 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
|
89 @code{copy-file} tries and fails to set the last-modification time of |
53454
bedee14106b1
(Standard Errors): Various small corrections and additions.
Luc Teirlinck <teirllm@auburn.edu>
parents:
52401
diff
changeset
|
90 the output file.@* |
bedee14106b1
(Standard Errors): Various small corrections and additions.
Luc Teirlinck <teirllm@auburn.edu>
parents:
52401
diff
changeset
|
91 @xref{Changing Files}. |
21007
66d807bdc5b4
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
16736
diff
changeset
|
92 |
2899 | 93 @item file-error |
53454
bedee14106b1
(Standard Errors): Various small corrections and additions.
Luc Teirlinck <teirllm@auburn.edu>
parents:
52401
diff
changeset
|
94 We do not list the error-strings of this error and its subcategories, |
bedee14106b1
(Standard Errors): Various small corrections and additions.
Luc Teirlinck <teirllm@auburn.edu>
parents:
52401
diff
changeset
|
95 because the error message is normally constructed from the data items |
bedee14106b1
(Standard Errors): Various small corrections and additions.
Luc Teirlinck <teirllm@auburn.edu>
parents:
52401
diff
changeset
|
96 alone when the error condition @code{file-error} is present. Thus, |
bedee14106b1
(Standard Errors): Various small corrections and additions.
Luc Teirlinck <teirllm@auburn.edu>
parents:
52401
diff
changeset
|
97 the error-strings are not very relevant. However, these error symbols |
bedee14106b1
(Standard Errors): Various small corrections and additions.
Luc Teirlinck <teirllm@auburn.edu>
parents:
52401
diff
changeset
|
98 do have @code{error-message} properties, and if no data is provided, |
bedee14106b1
(Standard Errors): Various small corrections and additions.
Luc Teirlinck <teirllm@auburn.edu>
parents:
52401
diff
changeset
|
99 the @code{error-message} property @emph{is} used.@* |
2899 | 100 @xref{Files}. |
101 | |
49600
23a1cea22d13
Trailing whitespace deleted.
Juanma Barranquero <lekktu@gmail.com>
parents:
38581
diff
changeset
|
102 @item file-locked |
25751
467b88fab665
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
22267
diff
changeset
|
103 This is a subcategory of @code{file-error}.@* |
2899 | 104 @xref{File Locks}. |
105 | |
106 @item file-supersession | |
25751
467b88fab665
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
22267
diff
changeset
|
107 This is a subcategory of @code{file-error}.@* |
7600 | 108 @xref{Modification Time}. |
2899 | 109 |
26288 | 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.@* | |
38581 | 113 @xref{Remote Files,,, emacs, The GNU Emacs Manual}. |
26288 | 114 |
2899 | 115 @item invalid-function |
116 @code{"Invalid function"}@* | |
65700
fcbeba67c06c
* errors.texi (Standard Errors): Corrected xrefs.
Chong Yidong <cyd@stupidchicken.com>
parents:
64889
diff
changeset
|
117 @xref{Function Indirection}. |
2899 | 118 |
119 @item invalid-read-syntax | |
120 @code{"Invalid read syntax"}@* | |
65700
fcbeba67c06c
* errors.texi (Standard Errors): Corrected xrefs.
Chong Yidong <cyd@stupidchicken.com>
parents:
64889
diff
changeset
|
121 @xref{Printed Representation}. |
2899 | 122 |
123 @item invalid-regexp | |
124 @code{"Invalid regexp"}@* | |
125 @xref{Regular Expressions}. | |
126 | |
21682
90da2489c498
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
21007
diff
changeset
|
127 @item mark-inactive |
53454
bedee14106b1
(Standard Errors): Various small corrections and additions.
Luc Teirlinck <teirllm@auburn.edu>
parents:
52401
diff
changeset
|
128 @code{"The mark is not active now"}@* |
21682
90da2489c498
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
21007
diff
changeset
|
129 @xref{The Mark}. |
90da2489c498
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
21007
diff
changeset
|
130 |
2899 | 131 @item no-catch |
132 @code{"No catch for tag"}@* | |
133 @xref{Catch and Throw}. | |
134 | |
21682
90da2489c498
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
21007
diff
changeset
|
135 @item scan-error |
90da2489c498
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
21007
diff
changeset
|
136 @code{"Scan error"}@* |
90da2489c498
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
21007
diff
changeset
|
137 This happens when certain syntax-parsing functions |
90da2489c498
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
21007
diff
changeset
|
138 find invalid syntax or mismatched parentheses.@* |
90da2489c498
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
21007
diff
changeset
|
139 @xref{List Motion}, and @ref{Parsing Expressions}. |
90da2489c498
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
21007
diff
changeset
|
140 |
2899 | 141 @item search-failed |
142 @code{"Search failed"}@* | |
143 @xref{Searching and Matching}. | |
144 | |
145 @item setting-constant | |
49600
23a1cea22d13
Trailing whitespace deleted.
Juanma Barranquero <lekktu@gmail.com>
parents:
38581
diff
changeset
|
146 @code{"Attempt to set a constant symbol"}@* |
21682
90da2489c498
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
21007
diff
changeset
|
147 The values of the symbols @code{nil} and @code{t}, |
90da2489c498
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
21007
diff
changeset
|
148 and any symbols that start with @samp{:}, |
2899 | 149 may not be changed.@* |
150 @xref{Constant Variables, , Variables that Never Change}. | |
151 | |
26288 | 152 @item text-read-only |
153 @code{"Text is read-only"}@* | |
53454
bedee14106b1
(Standard Errors): Various small corrections and additions.
Luc Teirlinck <teirllm@auburn.edu>
parents:
52401
diff
changeset
|
154 This is a subcategory of @code{buffer-read-only}.@* |
26288 | 155 @xref{Special Properties}. |
156 | |
12098 | 157 @item undefined-color |
158 @code{"Undefined color"}@* | |
159 @xref{Color Names}. | |
160 | |
2899 | 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 | |
12098 | 177 |
21682
90da2489c498
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
21007
diff
changeset
|
178 These kinds of error, which are classified as special cases of |
12098 | 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"}@* | |
53454
bedee14106b1
(Standard Errors): Various small corrections and additions.
Luc Teirlinck <teirllm@auburn.edu>
parents:
52401
diff
changeset
|
189 This is a subcategory of @code{domain-error}.@* |
12098 | 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"}@* | |
53454
bedee14106b1
(Standard Errors): Various small corrections and additions.
Luc Teirlinck <teirllm@auburn.edu>
parents:
52401
diff
changeset
|
198 This is a subcategory of @code{domain-error}.@* |
12098 | 199 @xref{Math Functions}. |
200 | |
201 @item underflow-error | |
202 @code{"Arithmetic underflow error"}@* | |
53454
bedee14106b1
(Standard Errors): Various small corrections and additions.
Luc Teirlinck <teirllm@auburn.edu>
parents:
52401
diff
changeset
|
203 This is a subcategory of @code{domain-error}.@* |
12098 | 204 @xref{Math Functions}. |
205 @end table | |
52401 | 206 |
207 @ignore | |
208 arch-tag: 717c6048-5d9d-4c7d-9a62-df57390b6f19 | |
209 @end ignore |