[Emacs-diffs] /srv/bzr/emacs/trunk r107430: Checked errors.texi

[Glenn Morris]

------------------------------------------------------------
revno: 107430
committer: Glenn Morris <address@hidden>
branch nick: trunk
timestamp: Sat 2012-02-25 12:59:46 -0800
message:
  Checked errors.texi
  
  * doc/lispref/errors.texi: Don't try to list _all_ the error symbols.
  Add circular-list, cl-assertion-failed, compression-error.
  * doc/lispref/elisp.texi, doc/lispref/vol1.texi, doc/lispref/vol2.texi:
  * doc/lispref/control.texi (Error Symbols): Tweak "Standard Errors" 
description.
  * admin/FOR-RELEASE: Related markup.
modified:
  admin/FOR-RELEASE
  doc/lispref/ChangeLog
  doc/lispref/control.texi
  doc/lispref/elisp.texi
  doc/lispref/errors.texi
  doc/lispref/vol1.texi
  doc/lispref/vol2.texi

=== modified file 'admin/FOR-RELEASE'
--- a/admin/FOR-RELEASE 2012-02-25 09:32:33 +0000
+++ b/admin/FOR-RELEASE 2012-02-25 20:59:46 +0000
@@ -194,7 +194,7 @@
 display.texi      
 edebug.texi
 elisp.texi
-errors.texi       
+errors.texi       rgm
 eval.texi         cyd
 files.texi        cyd
 frames.texi       

=== modified file 'doc/lispref/ChangeLog'
--- a/doc/lispref/ChangeLog     2012-02-25 15:31:07 +0000
+++ b/doc/lispref/ChangeLog     2012-02-25 20:59:46 +0000
@@ -1,3 +1,10 @@
+2012-02-25  Glenn Morris  <address@hidden>
+
+       * errors.texi: Don't try to list _all_ the error symbols.
+       Add circular-list, cl-assertion-failed, compression-error.
+       * elisp.texi, vol1.texi, vol2.texi:
+       * control.texi (Error Symbols): Tweak "Standard Errors" description.
+
 2012-02-25  Thierry Volpiatto  <address@hidden>
 
        * files.texi (files-equal-p, file-subdir-of-p): New,

=== modified file 'doc/lispref/control.texi'
--- a/doc/lispref/control.texi  2012-02-10 15:59:29 +0000
+++ b/doc/lispref/control.texi  2012-02-25 20:59:46 +0000
@@ -1234,7 +1234,7 @@
 when you write an error handler.  Using error symbols alone would
 eliminate all but the narrowest level of classification.
 
-  @xref{Standard Errors}, for a list of all the standard error symbols
+  @xref{Standard Errors}, for a list of the main error symbols
 and their conditions.
 
 @node Cleanups

=== modified file 'doc/lispref/elisp.texi'
--- a/doc/lispref/elisp.texi    2012-02-21 13:24:48 +0000
+++ b/doc/lispref/elisp.texi    2012-02-25 20:59:46 +0000
@@ -170,7 +170,7 @@
 * Tips::                    Advice and coding conventions for Emacs Lisp.
 * GNU Emacs Internals::     Building and dumping Emacs;
                               internal data structures.
-* Standard Errors::         List of all error symbols.
+* Standard Errors::         List of main error symbols.
 * Standard Buffer-Local Variables::
                             List of variables buffer-local in all buffers.
 * Standard Keymaps::        List of standard keymaps.

=== modified file 'doc/lispref/errors.texi'
--- a/doc/lispref/errors.texi   2012-02-24 08:28:42 +0000
+++ b/doc/lispref/errors.texi   2012-02-25 20:59:46 +0000
@@ -7,7 +7,7 @@
 @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.
@@ -24,6 +24,15 @@
   As a special exception, the error symbol @code{quit} does not have the
 condition @code{error}, because quitting is not considered an error.
 
address@hidden You can grep for "(put 'foo 'error-conditions ...) to find
address@hidden 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.
 
@@ -54,10 +63,16 @@
 @code{"Buffer is read-only"address@hidden
 @xref{Read Only Buffers}.
 
address@hidden
 @item circular-list
 @code{"List contains a loop"address@hidden
address@hidden ignore
+This happens when some operations (e.g. resolving face names)
+encounter circular address@hidden
address@hidden Objects}.
+
address@hidden cl-assertion-failed
address@hidden"Assertion failed"address@hidden
+This happens when the @code{assert} macro fails a address@hidden
address@hidden,,, cl, Common Lisp Extensions}.
 
 @item coding-system-error
 @code{"Invalid coding system"address@hidden
@@ -105,14 +120,23 @@
 the @code{error-message} property @emph{is} address@hidden
 @xref{Files}.
 
address@hidden jka-compr.el
address@hidden compression-error
+This is a subcategory of @code{file-error}, which results from
+problems handling a compressed address@hidden
address@hidden Programs Do Loading}.
+
address@hidden userlock.el
 @item file-locked
 This is a subcategory of @address@hidden
 @xref{File Locks}.
 
address@hidden userlock.el
 @item file-supersession
 This is a subcategory of @address@hidden
 @xref{Modification Time}.
 
address@hidden 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 address@hidden
@@ -130,6 +154,7 @@
 @code{"Invalid regexp"address@hidden
 @xref{Regular Expressions}.
 
address@hidden simple.el
 @item mark-inactive
 @code{"The mark is not active now"address@hidden
 @xref{The Mark}.
@@ -139,6 +164,7 @@
 @xref{Catch and Throw}.
 
 @ignore
address@hidden Not actually used for anything?  Probably definition should be 
removed.
 @item protected-field
 @code{"Attempt to modify a protected field"}
 @end ignore
@@ -160,6 +186,7 @@
 may not be address@hidden
 @xref{Constant Variables, , Variables that Never Change}.
 
address@hidden simple.el
 @item text-read-only
 @code{"Text is read-only"address@hidden
 This is a subcategory of @address@hidden

=== modified file 'doc/lispref/vol1.texi'
--- a/doc/lispref/vol1.texi     2012-02-21 13:24:48 +0000
+++ b/doc/lispref/vol1.texi     2012-02-25 20:59:46 +0000
@@ -187,7 +187,7 @@
 * Tips::                    Advice and coding conventions for Emacs Lisp.
 * GNU Emacs Internals::     Building and dumping Emacs;
                               internal data structures.
-* Standard Errors::         List of all error symbols.
+* Standard Errors::         List of main error symbols.
 * Standard Buffer-Local Variables::
                             List of variables buffer-local in all buffers.
 * Standard Keymaps::        List of standard keymaps.

=== modified file 'doc/lispref/vol2.texi'
--- a/doc/lispref/vol2.texi     2012-02-21 13:24:48 +0000
+++ b/doc/lispref/vol2.texi     2012-02-25 20:59:46 +0000
@@ -186,7 +186,7 @@
 * Tips::                    Advice and coding conventions for Emacs Lisp.
 * GNU Emacs Internals::     Building and dumping Emacs;
                               internal data structures.
-* Standard Errors::         List of all error symbols.
+* Standard Errors::         List of main error symbols.
 * Standard Buffer-Local Variables::
                             List of variables buffer-local in all buffers.
 * Standard Keymaps::        List of standard keymaps.