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