Convert the tla-generated versioning info to git-generated
[sxemacs] / info / lispref / errors.texi
1 @c -*-texinfo-*-
2 @c This is part of the SXEmacs Lisp Reference Manual.
3 @c Copyright (C) 1990, 1991, 1992, 1993 Free Software Foundation, Inc.
4 @c Copyright (C) 2005 Sebastian Freundt <hroptatyr@sxemacs.org>
5 @c See the file lispref.texi for copying conditions.
6 @setfilename ../../info/errors.info
7
8 @node Standard Errors, Standard Buffer-Local Variables, Building SXEmacs and Object Allocation, Top
9 @appendix 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}.
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
57 @item cyclic-function-indirection
58 @code{"Symbol's chain of function indirections contains a loop"}@*
59 @xref{Function Indirection}.
60
61 @c SXEmacs feature
62 @item domain-error
63 @code{"Arithmetic domain error"}@*
64
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"}@*
71 This is not a @code{file-error}.@*
72 @xref{Input Functions}.
73
74 @item file-error
75 This error and its subcategories do not have error-strings, because the
76 error message is constructed from the data items alone when the error
77 condition @code{file-error} is present.@*
78 @xref{Files}.
79
80 @item file-locked
81 This is a @code{file-error}.@*
82 @xref{File Locks}.
83
84 @item file-already-exists
85 This is a @code{file-error}.@*
86 @xref{Writing to Files}.
87
88 @item file-supersession
89 This is a @code{file-error}.@*
90 @xref{Modification Time}.
91
92 @item invalid-byte-code
93 @code{"Invalid byte code"}@*
94 @xref{Byte Compilation}.
95
96 @item invalid-function
97 @code{"Invalid function"}@*
98 @xref{Classifying Lists}.
99
100 @item invalid-read-syntax
101 @code{"Invalid read syntax"}@*
102 @xref{Input Functions}.
103
104 @item invalid-regexp
105 @code{"Invalid regexp"}@*
106 @xref{Regular Expressions}.
107
108 @c SXEmacs feature
109 @item mark-inactive
110 @code{"The mark is not active now"}@*
111
112 @item no-catch
113 @code{"No catch for tag"}@*
114 @xref{Catch and Throw}.
115
116 @c SXEmacs feature
117 @item overflow-error
118 @code{"Arithmetic overflow error"}@*
119
120 @c SXEmacs feature
121 @item protected-field
122 @code{"Attempt to modify a protected field"}@*
123
124 @c SXEmacs feature
125 @item range-error
126 @code{"Arithmetic range error"}@*
127
128 @item search-failed
129 @code{"Search failed"}@*
130 @xref{Searching and Matching}.
131
132 @item setting-constant
133 @code{"Attempt to set a constant symbol"}@*
134 @xref{Constant Variables, , Variables that Never Change}.
135
136 @c SXEmacs feature
137 @item singularity-error
138 @code{"Arithmetic singularity error"}@*
139
140 @c SXEmacs feature
141 @item tooltalk-error
142 @code{"ToolTalk error"}@*
143 @xref{ToolTalk Support}.
144
145 @c SXEmacs feature
146 @item undefined-keystroke-sequence
147 @code{"Undefined keystroke sequence"}@*
148
149 @ignore FSF Emacs only
150 @item undefined-color
151 @code{"Undefined color"}@*
152 @xref{Color Names}.
153 @end ignore
154
155 @item void-function
156 @code{"Symbol's function definition is void"}@*
157 @xref{Function Cells}.
158
159 @item void-variable
160 @code{"Symbol's value as variable is void"}@*
161 @xref{Accessing Variables}.
162
163 @item wrong-number-of-arguments
164 @code{"Wrong number of arguments"}@*
165 @xref{Classifying Lists}.
166
167 @item wrong-type-argument
168 @code{"Wrong type argument"}@*
169 @xref{Type Predicates}.
170 @end table
171
172   These error types, which are all classified as special cases of
173 @code{arith-error}, can occur on certain systems for invalid use of
174 mathematical functions.
175
176 @table @code
177 @item domain-error
178 @code{"Arithmetic domain error"}@*
179 @xref{Math Functions}.
180
181 @item overflow-error
182 @code{"Arithmetic overflow error"}@*
183 @xref{Math Functions}.
184
185 @item range-error
186 @code{"Arithmetic range error"}@*
187 @xref{Math Functions}.
188
189 @item singularity-error
190 @code{"Arithmetic singularity error"}@*
191 @xref{Math Functions}.
192
193 @item underflow-error
194 @code{"Arithmetic underflow error"}@*
195 @xref{Math Functions}.
196 @end table