[Python-checkins] r77121 - python/branches/py3k/Doc/library/exceptions.rst
georg.brandl
python-checkins at python.org
Tue Dec 29 22:38:35 CET 2009
Author: georg.brandl
Date: Tue Dec 29 22:38:35 2009
New Revision: 77121
Log:
#7590: exception classes no longer are in the "exceptions" module. Also clean up text that was written with string exceptions in mind.
Modified:
python/branches/py3k/Doc/library/exceptions.rst
Modified: python/branches/py3k/Doc/library/exceptions.rst
==============================================================================
--- python/branches/py3k/Doc/library/exceptions.rst (original)
+++ python/branches/py3k/Doc/library/exceptions.rst Tue Dec 29 22:38:35 2009
@@ -3,20 +3,12 @@
Built-in Exceptions
===================
-.. module:: exceptions
- :synopsis: Standard exception classes.
-
-
-Exceptions should be class objects. The exceptions are defined in the module
-:mod:`exceptions`. This module never needs to be imported explicitly: the
-exceptions are provided in the built-in namespace as well as the
-:mod:`exceptions` module.
-
.. index::
statement: try
statement: except
-For class exceptions, in a :keyword:`try` statement with an :keyword:`except`
+In Python, all exceptions must be instances of a class that derives from
+:class:`BaseException`. In a :keyword:`try` statement with an :keyword:`except`
clause that mentions a particular class, that clause also handles any exception
classes derived from that class (but not exception classes from which *it* is
derived). Two exception classes that are not related via subclassing are never
@@ -44,7 +36,7 @@
defining exceptions is available in the Python Tutorial under
:ref:`tut-userexceptions`.
-The following exceptions are only used as base classes for other exceptions.
+The following exceptions are used mostly as base classes for other exceptions.
.. XXX document with_traceback()
@@ -99,8 +91,8 @@
In this last case, :attr:`args` contains the verbatim constructor arguments as a
tuple.
-The following exceptions are the exceptions that are actually raised.
+The following exceptions are the exceptions that are usually raised.
.. exception:: AssertionError
@@ -369,10 +361,10 @@
associated value is a string indicating the type of the operands and the
operation.
+
The following exceptions are used as warning categories; see the :mod:`warnings`
module for more information.
-
.. exception:: Warning
Base class for warning categories.
More information about the Python-checkins
mailing list