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, 2001, 2002, 2003, 2004,
   4 @c   2005, 2006, 2007  Free Software Foundation, Inc.
   5 @c See the file elisp.texi for copying conditions.
   6 @setfilename ../info/errors
   7 @node Standard Errors, Standard Buffer-Local Variables, GNU Emacs Internals, Top
   8 @appendix Standard Errors
   9 @cindex standard errors
  10
  11   Here is the complete list of the error symbols in standard Emacs,
  12 grouped by concept.  The list includes each symbol's message (on the
  13 @code{error-message} property of the symbol) and a cross reference to a
  14 description of how the error can occur.
  15
  16   Each error symbol has an @code{error-conditions} property that is a
  17 list of symbols.  Normally this list includes the error symbol itself
  18 and the symbol @code{error}.  Occasionally it includes additional
  19 symbols, which are intermediate classifications, narrower than
  20 @code{error} but broader than a single error symbol.  For example, all
  21 the errors in accessing files have the condition @code{file-error}.  If
  22 we do not say here that a certain error symbol has additional error
  23 conditions, that means it has none.
  24
  25   As a special exception, the error symbol @code{quit} does not have the
  26 condition @code{error}, because quitting is not considered an error.
  27
  28   @xref{Errors}, for an explanation of how errors are generated and
  29 handled.
  30
  31 @table @code
  32 @item @var{symbol}
  33 @var{string}; @var{reference}.
  34
  35 @item error
  36 @code{"error"}@*
  37 @xref{Errors}.
  38
  39 @item quit
  40 @code{"Quit"}@*
  41 @xref{Quitting}.
  42
  43 @item args-out-of-range
  44 @code{"Args out of range"}@*
  45 This happens when trying to access an element beyond the range of a
  46 sequence or buffer.@*
  47 @xref{Sequences Arrays Vectors}, @xref{Text}.
  48
  49 @item arith-error
  50 @code{"Arithmetic error"}@*
  51 @xref{Arithmetic Operations}.
  52
  53 @item beginning-of-buffer
  54 @code{"Beginning of buffer"}@*
  55 @xref{Character Motion}.
  56
  57 @item buffer-read-only
  58 @code{"Buffer is read-only"}@*
  59 @xref{Read Only Buffers}.
  60
  61 @item coding-system-error
  62 @code{"Invalid coding system"}@*
  63 @xref{Lisp and Coding Systems}.
  64
  65 @item cyclic-function-indirection
  66 @code{"Symbol's chain of function indirections\@* contains a loop"}@*
  67 @xref{Function Indirection}.
  68
  69 @item cyclic-variable-indirection
  70 @code{"Symbol's chain of variable indirections\@* contains a loop"}@*
  71 @xref{Variable Aliases}.
  72
  73 @item end-of-buffer
  74 @code{"End of buffer"}@*
  75 @xref{Character Motion}.
  76
  77 @item end-of-file
  78 @code{"End of file during parsing"}@*
  79 Note that this is not a subcategory of @code{file-error},
  80 because it pertains to the Lisp reader, not to file I/O.@*
  81 @xref{Input Functions}.
  82
  83 @item file-already-exists
  84 This is a subcategory of @code{file-error}.@*
  85 @xref{Writing to Files}.
  86
  87 @item file-date-error
  88 This is a subcategory of @code{file-error}.  It occurs when
  89 @code{copy-file} tries and fails to set the last-modification time of
  90 the output file.@*
  91 @xref{Changing Files}.
  92
  93 @item file-error
  94 We do not list the error-strings of this error and its subcategories,
  95 because the error message is normally constructed from the data items
  96 alone when the error condition @code{file-error} is present.  Thus,
  97 the error-strings are not very relevant.  However, these error symbols
  98 do have @code{error-message} properties, and if no data is provided,
  99 the @code{error-message} property @emph{is} used.@*
 100 @xref{Files}.
 101
 102 @item file-locked
 103 This is a subcategory of @code{file-error}.@*
 104 @xref{File Locks}.
 105
 106 @item file-supersession
 107 This is a subcategory of @code{file-error}.@*
 108 @xref{Modification Time}.
 109
 110 @item ftp-error
 111 This is a subcategory of @code{file-error}, which results from problems
 112 in accessing a remote file using ftp.@*
 113 @xref{Remote Files,,, emacs, The GNU Emacs Manual}.
 114
 115 @item invalid-function
 116 @code{"Invalid function"}@*
 117 @xref{Function Indirection}.
 118
 119 @item invalid-read-syntax
 120 @code{"Invalid read syntax"}@*
 121 @xref{Printed Representation}.
 122
 123 @item invalid-regexp
 124 @code{"Invalid regexp"}@*
 125 @xref{Regular Expressions}.
 126
 127 @item mark-inactive
 128 @code{"The mark is not active now"}@*
 129 @xref{The Mark}.
 130
 131 @item no-catch
 132 @code{"No catch for tag"}@*
 133 @xref{Catch and Throw}.
 134
 135 @item scan-error
 136 @code{"Scan error"}@*
 137 This happens when certain syntax-parsing functions
 138 find invalid syntax or mismatched parentheses.@*
 139 @xref{List Motion}, and @ref{Parsing Expressions}.
 140
 141 @item search-failed
 142 @code{"Search failed"}@*
 143 @xref{Searching and Matching}.
 144
 145 @item setting-constant
 146 @code{"Attempt to set a constant symbol"}@*
 147 The values of the symbols @code{nil} and @code{t},
 148 and any symbols that start with @samp{:},
 149 may not be changed.@*
 150 @xref{Constant Variables, , Variables that Never Change}.
 151
 152 @item text-read-only
 153 @code{"Text is read-only"}@*
 154 This is a subcategory of @code{buffer-read-only}.@*
 155 @xref{Special Properties}.
 156
 157 @item undefined-color
 158 @code{"Undefined color"}@*
 159 @xref{Color Names}.
 160
 161 @item void-function
 162 @code{"Symbol's function definition is void"}@*
 163 @xref{Function Cells}.
 164
 165 @item void-variable
 166 @code{"Symbol's value as variable is void"}@*
 167 @xref{Accessing Variables}.
 168
 169 @item wrong-number-of-arguments
 170 @code{"Wrong number of arguments"}@*
 171 @xref{Classifying Lists}.
 172
 173 @item wrong-type-argument
 174 @code{"Wrong type argument"}@*
 175 @xref{Type Predicates}.
 176 @end table
 177
 178   These kinds of error, which are classified as special cases of
 179 @code{arith-error}, can occur on certain systems for invalid use of
 180 mathematical functions.
 181
 182 @table @code
 183 @item domain-error
 184 @code{"Arithmetic domain error"}@*
 185 @xref{Math Functions}.
 186
 187 @item overflow-error
 188 @code{"Arithmetic overflow error"}@*
 189 This is a subcategory of @code{domain-error}.@*
 190 @xref{Math Functions}.
 191
 192 @item range-error
 193 @code{"Arithmetic range error"}@*
 194 @xref{Math Functions}.
 195
 196 @item singularity-error
 197 @code{"Arithmetic singularity error"}@*
 198 This is a subcategory of @code{domain-error}.@*
 199 @xref{Math Functions}.
 200
 201 @item underflow-error
 202 @code{"Arithmetic underflow error"}@*
 203 This is a subcategory of @code{domain-error}.@*
 204 @xref{Math Functions}.
 205 @end table
 206
 207 @ignore
 208    arch-tag: 717c6048-5d9d-4c7d-9a62-df57390b6f19
 209 @end ignore