Rooba
/
cpython
mirror of https://github.com/python/cpython.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

Update comments relating to the removal of the -X option and of string 

exceptions in the interpreter and standard library.
This commit is contained in:
Fred Drake 2000-06-29 20:15:14 +00:00
parent c6e72e0b45
commit d04038d9d2
1 changed files with 11 additions and 16 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

27
Doc/api/api.tex
View File

@ -938,16 +938,15 @@ It may be called without holding the interpreter lock.
This utility function creates and returns a new exception object. The 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 \var{name} argument must be the name of the new exception, a C string
of the form \code{module.class}. The \var{base} and 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 class object derived from the root for all exceptions, the built-in
name \exception{Exception} (accessible in C as name \exception{Exception} (accessible in C as
\cdata{PyExc_Exception}). In this case the \member{__module__} \cdata{PyExc_Exception}). The \member{__module__} attribute of the
attribute of the new class is set to the first part (up to the last new class is set to the first part (up to the last dot) of the
dot) of the \var{name} argument, and the class name is set to the last \var{name} argument, and the class name is set to the last part (after
part (after the last dot). The the last dot). The \var{base} argument can be used to specify an
\var{base} argument can be used to specify an alternate base class. alternate base class. The \var{dict} argument can be used to specify
The \var{dict} argument can be used to specify a dictionary of class a dictionary of class variables and methods.
variables and methods.
\end{cfuncdesc} \end{cfuncdesc}
@ -991,21 +990,17 @@ completeness, here are all the variables:
Note: Note:
\begin{description} \begin{description}
\item[(1)] \item[(1)]
This is a base class for other standard exceptions. If the This is a base class for other standard exceptions.
\code{-X} interpreter option is used, these will be tuples
containing the string exceptions which would have otherwise been
subclasses.
\end{description} \end{description}
\section{Deprecation of String Exceptions} \section{Deprecation of String Exceptions}
The \code{-X} command-line option will be removed in Python 1.6. All All exceptions built into Python or provided in the standard library
exceptions built into Python or provided in the standard library will are derived from \exception{Exception}.
\withsubitem{(built-in exception)}{\ttindex{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 existing code to run unmodified, but this will also change in a future
release. release.