lispref/errors.texi

   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