Mercurial > emacs
annotate lispref/errors.texi @ 49506:ac9e2eeeb03d
New format of AUTHORS file; list each
author name once followed by contributed and changed files.
Improve selection of entries to include in list, and generate list
of unrecognized entries indicating syntax errors in ChangeLog files.
(authors-coding-system): New variable.
(authors-many-files): Update doc string.
(authors-aliases): Change format. Now one entry with multiple
aliases per author.
(authors-valid-file-names, authors-renamed-files-alist)
(authors-renamed-files-regexps): New variables.
(authors-canonical-file-name): New function. Validates that file
exists or occurs in one of the above lists. Record unrecognized
file names in global authors-invalid-file-names list.
(authors-add): Change to record per-change counts.
(authors-canonical-author-name): Handle new format of
authors-aliases list.
(authors-scan-change-log): Rename FILE arg to LOG-FILE.
Change doc string to describe new entry format.
Only add author entries for valid file names.
(authors-print): Replace by authors-add-to-author-list.
(authors-add-to-author-list): New function which reorders
per-file entries and adds them to global authors-author-list.
(authors): Instead of authors-print to insert in *Authors* buffer,
use authors-add-to-author-list to reorder the list and then
insert result in *Authors* buffer with new format.
Generate *Authors Errors* compilation-mode buffer listing
unrecognized ChangeLog entries.
author | Kim F. Storm <storm@cua.dk> |
---|---|
date | Wed, 29 Jan 2003 00:13:11 +0000 |
parents | 9f3e1a8c8870 |
children | 23a1cea22d13 |
rev | line source |
---|---|
2899 | 1 @c -*-texinfo-*- |
2 @c This is part of the GNU Emacs Lisp Reference Manual. | |
27189 | 3 @c Copyright (C) 1990, 1991, 1992, 1993, 1999 Free Software Foundation, Inc. |
2899 | 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 | |
7600 | 11 @code{error-message} property of the symbol) and a cross reference to a |
2899 | 12 description of how the error can occur. |
13 | |
7600 | 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 | |
2899 | 16 and the symbol @code{error}. Occasionally it includes additional |
7600 | 17 symbols, which are intermediate classifications, narrower than |
18 @code{error} but broader than a single error symbol. For example, all | |
21007
66d807bdc5b4
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
16736
diff
changeset
|
19 the errors in accessing files have the condition @code{file-error}. If |
66d807bdc5b4
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
16736
diff
changeset
|
20 we do not say here that a certain error symbol has additional error |
66d807bdc5b4
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
16736
diff
changeset
|
21 conditions, that means it has none. |
2899 | 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 | |
26288 | 57 @item coding-system-error |
58 @code{"Invalid coding system"}@* | |
59 @xref{Coding Systems}. | |
60 | |
12098 | 61 @item cyclic-function-indirection |
22267
dfac7398266b
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
22252
diff
changeset
|
62 @code{"Symbol's chain of function indirections\@* contains a loop"}@* |
12098 | 63 @xref{Function Indirection}. |
64 | |
2899 | 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"}@* | |
25751
467b88fab665
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
22267
diff
changeset
|
71 Note that this is not a subcategory of @code{file-error}, |
21682
90da2489c498
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
21007
diff
changeset
|
72 because it pertains to the Lisp reader, not to file I/O. |
2899 | 73 @xref{Input Functions}. |
74 | |
21682
90da2489c498
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
21007
diff
changeset
|
75 @item file-already-exists |
25751
467b88fab665
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
22267
diff
changeset
|
76 This is a subcategory of @code{file-error}.@* |
21682
90da2489c498
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
21007
diff
changeset
|
77 @xref{Writing to Files}. |
90da2489c498
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
21007
diff
changeset
|
78 |
21007
66d807bdc5b4
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
16736
diff
changeset
|
79 @item file-date-error |
66d807bdc5b4
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
16736
diff
changeset
|
80 This is a subcategory of @code{file-error}. It occurs when |
66d807bdc5b4
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
16736
diff
changeset
|
81 @code{copy-file} tries and fails to set the last-modification time of |
66d807bdc5b4
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
16736
diff
changeset
|
82 the output file. @xref{Changing Files}. |
66d807bdc5b4
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
16736
diff
changeset
|
83 |
2899 | 84 @item file-error |
7600 | 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.@* | |
2899 | 88 @xref{Files}. |
89 | |
90 @item file-locked | |
25751
467b88fab665
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
22267
diff
changeset
|
91 This is a subcategory of @code{file-error}.@* |
2899 | 92 @xref{File Locks}. |
93 | |
94 @item file-supersession | |
25751
467b88fab665
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
22267
diff
changeset
|
95 This is a subcategory of @code{file-error}.@* |
7600 | 96 @xref{Modification Time}. |
2899 | 97 |
26288 | 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.@* | |
38581 | 101 @xref{Remote Files,,, emacs, The GNU Emacs Manual}. |
26288 | 102 |
2899 | 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 | |
21682
90da2489c498
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
21007
diff
changeset
|
115 @item mark-inactive |
22138
d4ac295a98b3
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
21682
diff
changeset
|
116 @code{"Mark inactive"}@* |
21682
90da2489c498
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
21007
diff
changeset
|
117 @xref{The Mark}. |
90da2489c498
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
21007
diff
changeset
|
118 |
2899 | 119 @item no-catch |
120 @code{"No catch for tag"}@* | |
121 @xref{Catch and Throw}. | |
122 | |
21682
90da2489c498
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
21007
diff
changeset
|
123 @item scan-error |
90da2489c498
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
21007
diff
changeset
|
124 @code{"Scan error"}@* |
90da2489c498
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
21007
diff
changeset
|
125 This happens when certain syntax-parsing functions |
90da2489c498
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
21007
diff
changeset
|
126 find invalid syntax or mismatched parentheses.@* |
90da2489c498
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
21007
diff
changeset
|
127 @xref{List Motion}, and @ref{Parsing Expressions}. |
90da2489c498
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
21007
diff
changeset
|
128 |
2899 | 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"}@* | |
21682
90da2489c498
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
21007
diff
changeset
|
135 The values of the symbols @code{nil} and @code{t}, |
90da2489c498
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
21007
diff
changeset
|
136 and any symbols that start with @samp{:}, |
2899 | 137 may not be changed.@* |
138 @xref{Constant Variables, , Variables that Never Change}. | |
139 | |
26288 | 140 @item text-read-only |
141 @code{"Text is read-only"}@* | |
142 @xref{Special Properties}. | |
143 | |
12098 | 144 @item undefined-color |
145 @code{"Undefined color"}@* | |
146 @xref{Color Names}. | |
147 | |
2899 | 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 | |
12098 | 164 |
21682
90da2489c498
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
21007
diff
changeset
|
165 These kinds of error, which are classified as special cases of |
12098 | 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 |