diff options
Diffstat (limited to 'devdocs/elisp/standard-errors.html')
| -rw-r--r-- | devdocs/elisp/standard-errors.html | 50 |
1 files changed, 50 insertions, 0 deletions
diff --git a/devdocs/elisp/standard-errors.html b/devdocs/elisp/standard-errors.html new file mode 100644 index 00000000..d678c045 --- /dev/null +++ b/devdocs/elisp/standard-errors.html @@ -0,0 +1,50 @@ + <h2 class="appendix"> Standard Errors</h2> <p>Here is a list of the more important error symbols in standard Emacs, grouped by concept. The list includes each symbol’s message and a cross reference to a description of how the error can occur. </p> <p>Each error symbol has a set of parent error conditions that is a list of symbols. Normally this list includes the error symbol itself and the symbol <code>error</code>. Occasionally it includes additional symbols, which are intermediate classifications, narrower than <code>error</code> but broader than a single error symbol. For example, all the errors in accessing files have the condition <code>file-error</code>. If we do not say here that a certain error symbol has additional error conditions, that means it has none. </p> <p>As a special exception, the error symbols <code>quit</code> and <code>minibuffer-quit</code> don’t have the condition <code>error</code>, because quitting is not considered an error. </p> <p>Most of these error symbols are defined in C (mainly <samp>data.c</samp>), but some are defined in Lisp. For example, the file <samp>userlock.el</samp> defines the <code>file-locked</code> and <code>file-supersession</code> 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. </p> <p>See <a href="errors">Errors</a>, for an explanation of how errors are generated and handled. </p> <dl compact> <dt><code>error</code></dt> <dd> +<p>The message is ‘<samp>error</samp>’. See <a href="errors">Errors</a>. </p> </dd> <dt><code>quit</code></dt> <dd> +<p>The message is ‘<samp>Quit</samp>’. See <a href="quitting">Quitting</a>. </p> </dd> <dt><code>minibuffer-quit</code></dt> <dd> +<p>The message is ‘<samp>Quit</samp>’. This is a subcategory of <code>quit</code>. See <a href="quitting">Quitting</a>. </p> </dd> <dt><code>args-out-of-range</code></dt> <dd> +<p>The message is ‘<samp>Args out of range</samp>’. This happens when trying to access an element beyond the range of a sequence, buffer, or other container-like object. See <a href="sequences-arrays-vectors">Sequences Arrays Vectors</a>, and see <a href="text">Text</a>. </p> </dd> <dt><code>arith-error</code></dt> <dd> +<p>The message is ‘<samp>Arithmetic error</samp>’. This occurs when trying to perform integer division by zero. See <a href="numeric-conversions">Numeric Conversions</a>, and see <a href="arithmetic-operations">Arithmetic Operations</a>. </p> </dd> <dt><code>beginning-of-buffer</code></dt> <dd> +<p>The message is ‘<samp>Beginning of buffer</samp>’. See <a href="character-motion">Character Motion</a>. </p> </dd> <dt><code>buffer-read-only</code></dt> <dd> +<p>The message is ‘<samp>Buffer is read-only</samp>’. See <a href="read-only-buffers">Read Only Buffers</a>. </p> </dd> <dt><code>circular-list</code></dt> <dd> +<p>The message is ‘<samp>List contains a loop</samp>’. This happens when a circular structure is encountered. See <a href="circular-objects">Circular Objects</a>. </p> </dd> <dt><code>cl-assertion-failed</code></dt> <dd> +<p>The message is ‘<samp>Assertion failed</samp>’. This happens when the <code>cl-assert</code> macro fails a test. See <a href="https://www.gnu.org/software/emacs/manual/html_node/cl/Assertions.html#Assertions">Assertions</a> in <cite>Common Lisp Extensions</cite>. </p> </dd> <dt><code>coding-system-error</code></dt> <dd> +<p>The message is ‘<samp>Invalid coding system</samp>’. See <a href="lisp-and-coding-systems">Lisp and Coding Systems</a>. </p> </dd> <dt><code>cyclic-function-indirection</code></dt> <dd> +<p>The message is ‘<samp>Symbol's chain of function indirections contains a loop</samp>’. See <a href="function-indirection">Function Indirection</a>. </p> </dd> <dt><code>cyclic-variable-indirection</code></dt> <dd> +<p>The message is ‘<samp>Symbol's chain of variable indirections contains a loop</samp>’. See <a href="variable-aliases">Variable Aliases</a>. </p> </dd> <dt><code>dbus-error</code></dt> <dd> +<p>The message is ‘<samp>D-Bus error</samp>’. See <a href="https://www.gnu.org/software/emacs/manual/html_node/dbus/Errors-and-Events.html#Errors-and-Events">Errors and Events</a> in <cite>D-Bus integration in Emacs</cite>. </p> </dd> <dt><code>end-of-buffer</code></dt> <dd> +<p>The message is ‘<samp>End of buffer</samp>’. See <a href="character-motion">Character Motion</a>. </p> </dd> <dt><code>end-of-file</code></dt> <dd> +<p>The message is ‘<samp>End of file during parsing</samp>’. Note that this is not a subcategory of <code>file-error</code>, because it pertains to the Lisp reader, not to file I/O. See <a href="input-functions">Input Functions</a>. </p> </dd> <dt><code>file-already-exists</code></dt> <dd> +<p>This is a subcategory of <code>file-error</code>. See <a href="writing-to-files">Writing to Files</a>. </p> </dd> <dt><code>file-date-error</code></dt> <dd> +<p>This is a subcategory of <code>file-error</code>. It occurs when <code>copy-file</code> tries and fails to set the last-modification time of the output file. See <a href="changing-files">Changing Files</a>. </p> </dd> <dt><code>file-error</code></dt> <dd> +<p>We do not list the error-strings of this error and its subcategories, because the error message is normally constructed from the data items alone when the error condition <code>file-error</code> is present. Thus, the error-strings are not very relevant. However, these error symbols do have <code>error-message</code> properties, and if no data is provided, the <code>error-message</code> property <em>is</em> used. See <a href="files">Files</a>. </p> </dd> <dt><code>file-missing</code></dt> <dd> +<p>This is a subcategory of <code>file-error</code>. It occurs when an operation attempts to act on a file that is missing. See <a href="changing-files">Changing Files</a>. </p> </dd> <dt><code>compression-error</code></dt> <dd> +<p>This is a subcategory of <code>file-error</code>, which results from problems handling a compressed file. See <a href="how-programs-do-loading">How Programs Do Loading</a>. </p> </dd> <dt><code>file-locked</code></dt> <dd> +<p>This is a subcategory of <code>file-error</code>. See <a href="file-locks">File Locks</a>. </p> </dd> <dt><code>file-supersession</code></dt> <dd> +<p>This is a subcategory of <code>file-error</code>. See <a href="modification-time">Modification Time</a>. </p> </dd> <dt><code>file-notify-error</code></dt> <dd> +<p>This is a subcategory of <code>file-error</code>. It happens, when a file could not be watched for changes. See <a href="file-notifications">File Notifications</a>. </p> </dd> <dt><code>remote-file-error</code></dt> <dd> +<p>This is a subcategory of <code>file-error</code>, which results from problems in accessing a remote file. See <a href="https://www.gnu.org/software/emacs/manual/html_node/emacs/Remote-Files.html#Remote-Files">Remote Files</a> in <cite>The GNU Emacs Manual</cite>. Often, this error appears when timers, process filters, process sentinels or special events in general try to access a remote file, and collide with another remote file operation. In general it is a good idea to write a bug report. See <a href="https://www.gnu.org/software/emacs/manual/html_node/emacs/Bugs.html#Bugs">Bugs</a> in <cite>The GNU Emacs Manual</cite>. </p> </dd> <dt><code>ftp-error</code></dt> <dd> +<p>This is a subcategory of <code>remote-file-error</code>, which results from problems in accessing a remote file using ftp. See <a href="https://www.gnu.org/software/emacs/manual/html_node/emacs/Remote-Files.html#Remote-Files">Remote Files</a> in <cite>The GNU Emacs Manual</cite>. </p> </dd> <dt><code>invalid-function</code></dt> <dd> +<p>The message is ‘<samp>Invalid function</samp>’. See <a href="function-indirection">Function Indirection</a>. </p> </dd> <dt><code>invalid-read-syntax</code></dt> <dd> +<p>The message is usually ‘<samp>Invalid read syntax</samp>’. See <a href="printed-representation">Printed Representation</a>. This error can also be raised by commands like <code>eval-expression</code> when there’s text following an expression. In that case, the message is ‘<samp>Trailing garbage following expression</samp>’. </p> </dd> <dt><code>invalid-regexp</code></dt> <dd> +<p>The message is ‘<samp>Invalid regexp</samp>’. See <a href="regular-expressions">Regular Expressions</a>. </p> </dd> <dt><code>mark-inactive</code></dt> <dd> +<p>The message is ‘<samp>The mark is not active now</samp>’. See <a href="the-mark">The Mark</a>. </p> </dd> <dt><code>no-catch</code></dt> <dd> +<p>The message is ‘<samp>No catch for tag</samp>’. See <a href="catch-and-throw">Catch and Throw</a>. </p> </dd> <dt><code>range-error</code></dt> <dd> +<p>The message is <code>Arithmetic range error</code>. </p> </dd> <dt><code>overflow-error</code></dt> <dd> +<p>The message is ‘<samp>Arithmetic overflow error</samp>’. This is a subcategory of <code>range-error</code>. This can happen with integers exceeding the <code>integer-width</code> limit. See <a href="integer-basics">Integer Basics</a>. </p> </dd> <dt><code>scan-error</code></dt> <dd> +<p>The message is ‘<samp>Scan error</samp>’. This happens when certain syntax-parsing functions find invalid syntax or mismatched parentheses. Conventionally raised with three argument: a human-readable error message, the start of the obstacle that cannot be moved over, and the end of the obstacle. See <a href="list-motion">List Motion</a>, and see <a href="parsing-expressions">Parsing Expressions</a>. </p> </dd> <dt><code>search-failed</code></dt> <dd> +<p>The message is ‘<samp>Search failed</samp>’. See <a href="searching-and-matching">Searching and Matching</a>. </p> </dd> <dt><code>setting-constant</code></dt> <dd> +<p>The message is ‘<samp>Attempt to set a constant symbol</samp>’. This happens when attempting to assign values to <code>nil</code>, <code>t</code>, <code>most-positive-fixnum</code>, <code>most-negative-fixnum</code>, and keyword symbols. It also happens when attempting to assign values to <code>enable-multibyte-characters</code> and some other symbols whose direct assignment is not allowed for some reason. See <a href="constant-variables">Constant Variables</a>. </p> </dd> <dt><code>text-read-only</code></dt> <dd> +<p>The message is ‘<samp>Text is read-only</samp>’. This is a subcategory of <code>buffer-read-only</code>. See <a href="special-properties">Special Properties</a>. </p> </dd> <dt><code>undefined-color</code></dt> <dd> +<p>The message is ‘<samp>Undefined color</samp>’. See <a href="color-names">Color Names</a>. </p> </dd> <dt><code>user-error</code></dt> <dd> +<p>The message is the empty string. See <a href="signaling-errors">Signaling Errors</a>. </p> </dd> <dt><code>user-search-failed</code></dt> <dd> +<p>This is like ‘<samp>search-failed</samp>’, but doesn’t trigger the debugger, like ‘<samp>user-error</samp>’. See <a href="signaling-errors">Signaling Errors</a>, and see <a href="searching-and-matching">Searching and Matching</a>. This is used for searching in Info files, see <a href="https://www.gnu.org/software/emacs/manual/html_node/info/Search-Text.html#Search-Text">Search Text</a> in <cite>Info</cite>. </p> </dd> <dt><code>void-function</code></dt> <dd> +<p>The message is ‘<samp>Symbol's function definition is void</samp>’. See <a href="function-cells">Function Cells</a>. </p> </dd> <dt><code>void-variable</code></dt> <dd> +<p>The message is ‘<samp>Symbol's value as variable is void</samp>’. See <a href="accessing-variables">Accessing Variables</a>. </p> </dd> <dt><code>wrong-number-of-arguments</code></dt> <dd> +<p>The message is ‘<samp>Wrong number of arguments</samp>’. See <a href="argument-list">Argument List</a>. </p> </dd> <dt><code>wrong-type-argument</code></dt> <dd> +<p>The message is ‘<samp>Wrong type argument</samp>’. See <a href="type-predicates">Type Predicates</a>. </p> </dd> <dt><code>unknown-image-type</code></dt> <dd> +<p>The message is ‘<samp>Cannot determine image type</samp>’. See <a href="images">Images</a>. </p> </dd> <dt><code>inhibited-interaction</code></dt> <dd><p>The message is ‘<samp>User interaction while inhibited</samp>’. This error is signalled when <code>inhibit-interaction</code> is non-<code>nil</code> and a user interaction function (like <code>read-from-minibuffer</code>) is called. </p></dd> </dl><div class="_attribution"> + <p class="_attribution-p"> + Copyright © 1990-1996, 1998-2022 Free Software Foundation, Inc. <br>Licensed under the GNU GPL license.<br> + <a href="https://www.gnu.org/software/emacs/manual/html_node/elisp/Standard-Errors.html" class="_attribution-link">https://www.gnu.org/software/emacs/manual/html_node/elisp/Standard-Errors.html</a> + </p> +</div> |