42be1cd914255b44f2f73f6bd8b759846b08a5fc
[chise/xemacs-chise.git.1] / man / lispref / errors.texi
1 @c -*-texinfo-*-
2 @c This is part of the XEmacs Lisp Reference Manual.
3 @c Copyright (C) 1990, 1991, 1992, 1993 Free Software Foundation, Inc. 
4 @c See the file lispref.texi for copying conditions.
5 @setfilename ../../info/errors.info
6 @node Standard Errors, Standard Buffer-Local Variables, Building XEmacs and Object Allocation, 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
11 @code{error-message} property of the symbol) and a cross reference to a
12 description of how the error can occur.
13
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}.
20
21   As a special exception, the error symbol @code{quit} does not have the
22 condition @code{error}, because quitting is not considered an error.
23
24   @xref{Errors}, for an explanation of how errors are generated and
25 handled.
26
27 @table @code
28 @item @var{symbol}
29 @var{string}; @var{reference}.
30
31 @item error
32 @code{"error"}@*
33 @xref{Errors}.
34
35 @item quit
36 @code{"Quit"}@*
37 @xref{Quitting}.
38
39 @item args-out-of-range
40 @code{"Args out of range"}@*
41 @xref{Sequences Arrays Vectors}.
42
43 @item arith-error
44 @code{"Arithmetic error"}@*
45 See @code{/} and @code{%} in @ref{Numbers}.
46
47 @item beginning-of-buffer
48 @code{"Beginning of buffer"}@*
49 @xref{Motion}.
50
51 @item buffer-read-only
52 @code{"Buffer is read-only"}@*
53 @xref{Read Only Buffers}.
54
55 @item cyclic-function-indirection
56 @code{"Symbol's chain of function indirections contains a loop"}@*
57 @xref{Function Indirection}.
58
59 @c XEmacs feature
60 @item domain-error
61 @code{"Arithmetic domain error"}@*
62
63 @item end-of-buffer
64 @code{"End of buffer"}@*
65 @xref{Motion}.
66
67 @item end-of-file
68 @code{"End of file during parsing"}@*
69 This is not a @code{file-error}.@*
70 @xref{Input Functions}.
71
72 @item file-error
73 This error and its subcategories do not have error-strings, because the
74 error message is constructed from the data items alone when the error
75 condition @code{file-error} is present.@*
76 @xref{Files}.
77
78 @item file-locked     
79 This is a @code{file-error}.@*
80 @xref{File Locks}.
81
82 @item file-already-exists
83 This is a @code{file-error}.@*
84 @xref{Writing to Files}.
85
86 @item file-supersession
87 This is a @code{file-error}.@*
88 @xref{Modification Time}.
89
90 @item invalid-function
91 @code{"Invalid function"}@*
92 @xref{Classifying Lists}.
93
94 @item invalid-read-syntax
95 @code{"Invalid read syntax"}@*
96 @xref{Input Functions}.
97
98 @item invalid-regexp
99 @code{"Invalid regexp"}@*
100 @xref{Regular Expressions}.
101
102 @c XEmacs feature
103 @item mark-inactive
104 @code{"The mark is not active now"}@*
105
106 @item no-catch
107 @code{"No catch for tag"}@*
108 @xref{Catch and Throw}.
109
110 @c XEmacs feature
111 @item overflow-error
112 @code{"Arithmetic overflow error"}@*
113
114 @c XEmacs feature
115 @item protected-field
116 @code{"Attempt to modify a protected field"}@*
117
118 @c XEmacs feature
119 @item range-error
120 @code{"Arithmetic range error"}@*
121
122 @item search-failed
123 @code{"Search failed"}@*
124 @xref{Searching and Matching}.
125
126 @item setting-constant
127 @code{"Attempt to set a constant symbol"}@* 
128 The values of the symbols @code{nil} and @code{t}
129 may not be changed.@*
130 @xref{Constant Variables, , Variables that Never Change}.
131
132 @c XEmacs feature
133 @item singularity-error
134 @code{"Arithmetic singularity error"}@*
135
136 @c XEmacs feature
137 @item tooltalk-error
138 @code{"ToolTalk error"}@*
139 @xref{ToolTalk Support}.
140
141 @c XEmacs feature
142 @item undefined-keystroke-sequence
143 @code{"Undefined keystroke sequence"}@*
144
145 @c XEmacs feature
146 @item underflow-error
147 @code{"Arithmetic underflow error"}@*
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