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