@appendix Standard Errors
@cindex standard errors
- Here is the complete list of the error symbols in standard Emacs,
+ Here is a list of the more important error symbols in standard Emacs,
grouped by concept. The list includes each symbol's message (on the
@code{error-message} property of the symbol) and a cross reference to a
description of how the error can occur.
As a special exception, the error symbol @code{quit} does not have the
condition @code{error}, because quitting is not considered an error.
+@c You can grep for "(put 'foo 'error-conditions ...) to find
+@c examples defined in Lisp. Eg soap-client.el, sasl.el.
+ Most of these error symbols are defined in C (mainly @file{data.c}),
+but some are defined in Lisp. For example, the file @file{userlock.el}
+defines the @code{file-locked} and @code{file-supersession} errors.
+Several of the specialized Lisp libraries distributed with Emacs
+define their own error symbols. We do not attempt to list of all
+those here.
+
@xref{Errors}, for an explanation of how errors are generated and
handled.
@code{"Buffer is read-only"}@*
@xref{Read Only Buffers}.
-@ignore
@item circular-list
@code{"List contains a loop"}@*
-@end ignore
+This happens when some operations (e.g. resolving face names)
+encounter circular structures.@*
+@xref{Circular Objects}.
+
+@item cl-assertion-failed
+@code{"Assertion failed"}@*
+This happens when the @code{assert} macro fails a test.@*
+@xref{Assertions,,, cl, Common Lisp Extensions}.
@item coding-system-error
@code{"Invalid coding system"}@*
the @code{error-message} property @emph{is} used.@*
@xref{Files}.
+@c jka-compr.el
+@item compression-error
+This is a subcategory of @code{file-error}, which results from
+problems handling a compressed file.@*
+@xref{How Programs Do Loading}.
+
+@c userlock.el
@item file-locked
This is a subcategory of @code{file-error}.@*
@xref{File Locks}.
+@c userlock.el
@item file-supersession
This is a subcategory of @code{file-error}.@*
@xref{Modification Time}.
+@c net/ange-ftp.el
@item ftp-error
This is a subcategory of @code{file-error}, which results from problems
in accessing a remote file using ftp.@*
@code{"Invalid regexp"}@*
@xref{Regular Expressions}.
+@c simple.el
@item mark-inactive
@code{"The mark is not active now"}@*
@xref{The Mark}.
@xref{Catch and Throw}.
@ignore
+@c Not actually used for anything? Probably definition should be removed.
@item protected-field
@code{"Attempt to modify a protected field"}
@end ignore
may not be changed.@*
@xref{Constant Variables, , Variables that Never Change}.
+@c simple.el
@item text-read-only
@code{"Text is read-only"}@*
This is a subcategory of @code{buffer-read-only}.@*
projects / emacs.git / commitdiff