summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorFred Drake <fdrake@acm.org>2000-06-29 20:15:14 (GMT)
committerFred Drake <fdrake@acm.org>2000-06-29 20:15:14 (GMT)
commitd04038d9d2f7950d533a33d6c01b7911f90c0c2a (patch)
tree9c2f7673247eb636927f09a78beaa13cc16b984e
parentc6e72e0b457d75b99a3bedf952190459e6f8df0a (diff)
downloadcpython-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.
-rw-r--r--Doc/api/api.tex27
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.