XEmacs 21.2.5
[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-byte-code
91 @code{"Invalid byte code"}@*
92 @xref{Byte Compilation}.
93
94 @item invalid-function
95 @code{"Invalid function"}@*
96 @xref{Classifying Lists}.
97
98 @item invalid-read-syntax
99 @code{"Invalid read syntax"}@*
100 @xref{Input Functions}.
101
102 @item invalid-regexp
103 @code{"Invalid regexp"}@*
104 @xref{Regular Expressions}.
105
106 @c XEmacs feature
107 @item mark-inactive
108 @code{"The mark is not active now"}@*
109
110 @item no-catch
111 @code{"No catch for tag"}@*
112 @xref{Catch and Throw}.
113
114 @c XEmacs feature
115 @item overflow-error
116 @code{"Arithmetic overflow error"}@*
117
118 @c XEmacs feature
119 @item protected-field
120 @code{"Attempt to modify a protected field"}@*
121
122 @c XEmacs feature
123 @item range-error
124 @code{"Arithmetic range error"}@*
125
126 @item search-failed
127 @code{"Search failed"}@*
128 @xref{Searching and Matching}.
129
130 @item setting-constant
131 @code{"Attempt to set a constant symbol"}@* 
132 @xref{Constant Variables, , Variables that Never Change}.
133
134 @c XEmacs feature
135 @item singularity-error
136 @code{"Arithmetic singularity error"}@*
137
138 @c XEmacs feature
139 @item tooltalk-error
140 @code{"ToolTalk error"}@*
141 @xref{ToolTalk Support}.
142
143 @c XEmacs feature
144 @item undefined-keystroke-sequence
145 @code{"Undefined keystroke sequence"}@*
146
147 @ignore FSF Emacs only
148 @item undefined-color
149 @code{"Undefined color"}@*
150 @xref{Color Names}.
151 @end ignore
152
153 @item void-function
154 @code{"Symbol's function definition is void"}@*
155 @xref{Function Cells}.
156
157 @item void-variable
158 @code{"Symbol's value as variable is void"}@*
159 @xref{Accessing Variables}.
160
161 @item wrong-number-of-arguments
162 @code{"Wrong number of arguments"}@*
163 @xref{Classifying Lists}.
164
165 @item wrong-type-argument
166 @code{"Wrong type argument"}@*
167 @xref{Type Predicates}.
168 @end table
169
170   These error types, which are all classified as special cases of
171 @code{arith-error}, can occur on certain systems for invalid use of
172 mathematical functions.
173
174 @table @code
175 @item domain-error
176 @code{"Arithmetic domain error"}@*
177 @xref{Math Functions}.
178
179 @item overflow-error
180 @code{"Arithmetic overflow error"}@*
181 @xref{Math Functions}.
182
183 @item range-error
184 @code{"Arithmetic range error"}@*
185 @xref{Math Functions}.
186
187 @item singularity-error
188 @code{"Arithmetic singularity error"}@*
189 @xref{Math Functions}.
190
191 @item underflow-error
192 @code{"Arithmetic underflow error"}@*
193 @xref{Math Functions}.
194 @end table