diff options
author | Fred Drake <fdrake@acm.org> | 2000-06-29 20:15:14 (GMT) |
---|---|---|
committer | Fred Drake <fdrake@acm.org> | 2000-06-29 20:15:14 (GMT) |
commit | d04038d9d2f7950d533a33d6c01b7911f90c0c2a (patch) | |
tree | 9c2f7673247eb636927f09a78beaa13cc16b984e /Doc/api | |
parent | c6e72e0b457d75b99a3bedf952190459e6f8df0a (diff) | |
download | cpython-d04038d9d2f7950d533a33d6c01b7911f90c0c2a.zip cpython-d04038d9d2f7950d533a33d6c01b7911f90c0c2a.tar.gz cpython-d04038d9d2f7950d533a33d6c01b7911f90c0c2a.tar.bz2 |
Update comments relating to the removal of the -X option and of string
exceptions in the interpreter and standard library.
Diffstat (limited to 'Doc/api')
-rw-r--r-- | Doc/api/api.tex | 27 |
1 files changed, 11 insertions, 16 deletions
diff --git a/Doc/api/api.tex b/Doc/api/api.tex index c7b2d45..3c27148 100644 --- a/Doc/api/api.tex +++ b/Doc/api/api.tex @@ -938,16 +938,15 @@ It may be called without holding the interpreter lock. This utility function creates and returns a new exception object. The \var{name} argument must be the name of the new exception, a C string of the form \code{module.class}. The \var{base} and -\var{dict} arguments are normally \NULL{}. Normally, this creates a +\var{dict} arguments are normally \NULL{}. This creates a class object derived from the root for all exceptions, the built-in name \exception{Exception} (accessible in C as -\cdata{PyExc_Exception}). In this case the \member{__module__} -attribute of the new class is set to the first part (up to the last -dot) of the \var{name} argument, and the class name is set to the last -part (after the last dot). The -\var{base} argument can be used to specify an alternate base class. -The \var{dict} argument can be used to specify a dictionary of class -variables and methods. +\cdata{PyExc_Exception}). The \member{__module__} attribute of the +new class is set to the first part (up to the last dot) of the +\var{name} argument, and the class name is set to the last part (after +the last dot). The \var{base} argument can be used to specify an +alternate base class. The \var{dict} argument can be used to specify +a dictionary of class variables and methods. \end{cfuncdesc} @@ -991,21 +990,17 @@ completeness, here are all the variables: Note: \begin{description} \item[(1)] - This is a base class for other standard exceptions. If the - \code{-X} interpreter option is used, these will be tuples - containing the string exceptions which would have otherwise been - subclasses. + This is a base class for other standard exceptions. \end{description} \section{Deprecation of String Exceptions} -The \code{-X} command-line option will be removed in Python 1.6. All -exceptions built into Python or provided in the standard library will +All exceptions built into Python or provided in the standard library +are derived from \exception{Exception}. \withsubitem{(built-in exception)}{\ttindex{Exception}} -be classes derived from \exception{Exception}. -String exceptions will still be supported in the interpreter to allow +String exceptions are still supported in the interpreter to allow existing code to run unmodified, but this will also change in a future release. |