| 1 | @c -*-texinfo-*- |
| 2 | @c This is part of the GNU Emacs Lisp Reference Manual. |
| 3 | @c Copyright (C) 1990, 1991, 1992, 1993, 1999 Free Software Foundation, Inc. |
| 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 |
| 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}. If |
| 20 | we do not say here that a certain error symbol has additional error |
| 21 | conditions, that means it has none. |
| 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 coding-system-error |
| 58 | @code{"Invalid coding system"}@* |
| 59 | @xref{Coding Systems}. |
| 60 | |
| 61 | @item cyclic-function-indirection |
| 62 | @code{"Symbol's chain of function indirections\@* contains a loop"}@* |
| 63 | @xref{Function Indirection}. |
| 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 | Note that this is not a subcategory of @code{file-error}, |
| 72 | because it pertains to the Lisp reader, not to file I/O. |
| 73 | @xref{Input Functions}. |
| 74 | |
| 75 | @item file-already-exists |
| 76 | This is a subcategory of @code{file-error}.@* |
| 77 | @xref{Writing to Files}. |
| 78 | |
| 79 | @item file-date-error |
| 80 | This is a subcategory of @code{file-error}. It occurs when |
| 81 | @code{copy-file} tries and fails to set the last-modification time of |
| 82 | the output file. @xref{Changing Files}. |
| 83 | |
| 84 | @item file-error |
| 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.@* |
| 88 | @xref{Files}. |
| 89 | |
| 90 | @item file-locked |
| 91 | This is a subcategory of @code{file-error}.@* |
| 92 | @xref{File Locks}. |
| 93 | |
| 94 | @item file-supersession |
| 95 | This is a subcategory of @code{file-error}.@* |
| 96 | @xref{Modification Time}. |
| 97 | |
| 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.@* |
| 101 | @xref{Remote Files,,, emacs, The GNU Emacs Manual}. |
| 102 | |
| 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 | |
| 115 | @item mark-inactive |
| 116 | @code{"Mark inactive"}@* |
| 117 | @xref{The Mark}. |
| 118 | |
| 119 | @item no-catch |
| 120 | @code{"No catch for tag"}@* |
| 121 | @xref{Catch and Throw}. |
| 122 | |
| 123 | @item scan-error |
| 124 | @code{"Scan error"}@* |
| 125 | This happens when certain syntax-parsing functions |
| 126 | find invalid syntax or mismatched parentheses.@* |
| 127 | @xref{List Motion}, and @ref{Parsing Expressions}. |
| 128 | |
| 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"}@* |
| 135 | The values of the symbols @code{nil} and @code{t}, |
| 136 | and any symbols that start with @samp{:}, |
| 137 | may not be changed.@* |
| 138 | @xref{Constant Variables, , Variables that Never Change}. |
| 139 | |
| 140 | @item text-read-only |
| 141 | @code{"Text is read-only"}@* |
| 142 | @xref{Special Properties}. |
| 143 | |
| 144 | @item undefined-color |
| 145 | @code{"Undefined color"}@* |
| 146 | @xref{Color Names}. |
| 147 | |
| 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 |
| 164 | |
| 165 | These kinds of error, which are classified as special cases of |
| 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 |