]> git.ipfire.org Git - thirdparty/Python/cpython.git/commitdiff
Document the correct class hierarchy for SystemExit. It is not an
authorBarry Warsaw <barry@python.org>
Wed, 24 Feb 1999 00:27:14 +0000 (00:27 +0000)
committerBarry Warsaw <barry@python.org>
Wed, 24 Feb 1999 00:27:14 +0000 (00:27 +0000)
error and so it derives from Exception and not SystemError.

Doc/lib/libexcs.tex

index 8c15a95a49ce2eb73e7ca5616490722b105e4b0f..2ff64a35139bc51549507ecaab67665e91e5c727 100644 (file)
@@ -13,7 +13,8 @@ exceptions is present in the standard library module
 
 For backward compatibility, when Python is invoked with the \code{-X}
 option, most of the standard exceptions are strings\footnote{For
-forward-compatibility the new exceptions \exception{LookupError},
+forward-compatibility the new exceptions \exception{Exception},
+\exception{LookupError},
 \exception{ArithmeticError}, \exception{EnvironmentError}, and
 \exception{StandardError} are tuples.}.  This option may be used to
 run code that breaks because of the different semantics of class based
@@ -76,8 +77,9 @@ also available on the instance's \member{args} attribute, as a tuple.
 \end{excdesc}
 
 \begin{excdesc}{StandardError}
-The base class for built-in exceptions.  All built-in exceptions are
-derived from this class, which is itself derived from the root class
+The base class for all built-in exceptions except
+\exception{SystemExit}.  \exception{StandardError} itself is derived
+from the root class
 \exception{Exception}.
 \end{excdesc}
 
@@ -288,7 +290,9 @@ For class exceptions, \function{str()} returns only the message.
 
 When class exceptions are used, the instance has an attribute
 \member{code} which is set to the proposed exit status or error message
-(defaulting to \code{None}).
+(defaulting to \code{None}).  Also, this exception derives directly
+from \exception{Exception} and not \exception{StandardError}, since it 
+is not technically an error.
   
   A call to \function{sys.exit()} is translated into an exception so that
   clean-up handlers (\keyword{finally} clauses of \keyword{try} statements)