Commit 763557ea authored by csabella's avatar csabella Committed by terryjreedy

bpo-17188: DOC: Document 'from None' in raise statement (#1671)

Original patch by Dennis Mårtensson.
parent d896985b
...@@ -587,7 +587,7 @@ printed:: ...@@ -587,7 +587,7 @@ printed::
... ...
Traceback (most recent call last): Traceback (most recent call last):
File "<stdin>", line 2, in <module> File "<stdin>", line 2, in <module>
ZeroDivisionError: int division or modulo by zero ZeroDivisionError: division by zero
The above exception was the direct cause of the following exception: The above exception was the direct cause of the following exception:
...@@ -606,7 +606,7 @@ attached as the new exception's :attr:`__context__` attribute:: ...@@ -606,7 +606,7 @@ attached as the new exception's :attr:`__context__` attribute::
... ...
Traceback (most recent call last): Traceback (most recent call last):
File "<stdin>", line 2, in <module> File "<stdin>", line 2, in <module>
ZeroDivisionError: int division or modulo by zero ZeroDivisionError: division by zero
During handling of the above exception, another exception occurred: During handling of the above exception, another exception occurred:
...@@ -614,9 +614,27 @@ attached as the new exception's :attr:`__context__` attribute:: ...@@ -614,9 +614,27 @@ attached as the new exception's :attr:`__context__` attribute::
File "<stdin>", line 4, in <module> File "<stdin>", line 4, in <module>
RuntimeError: Something bad happened RuntimeError: Something bad happened
Exception chaining can be explicitly suppressed by specifying :const:`None` in
the ``from`` clause::
>>> try:
... print(1 / 0)
... except:
... raise RuntimeError("Something bad happened") from None
...
Traceback (most recent call last):
File "<stdin>", line 4, in <module>
RuntimeError: Something bad happened
Additional information on exceptions can be found in section :ref:`exceptions`, Additional information on exceptions can be found in section :ref:`exceptions`,
and information about handling exceptions is in section :ref:`try`. and information about handling exceptions is in section :ref:`try`.
.. versionchanged:: 3.3
:const:`None` is now permitted as ``Y`` in ``raise X from Y``
.. versionadded:: 3.3
The ``__suppress_context__`` attribute to suppress automatic display of the
exception context
.. _break: .. _break:
......
...@@ -965,6 +965,7 @@ David Marek ...@@ -965,6 +965,7 @@ David Marek
Doug Marien Doug Marien
Sven Marnach Sven Marnach
Alex Martelli Alex Martelli
Dennis Mårtensson
Anthony Martin Anthony Martin
Owen Martin Owen Martin
Sidney San Martín Sidney San Martín
......
Markdown is supported
0%
or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment