homepage

Language manual, section 7.8. The raise statement has no mention of the 'from None' option. Indeed it says "if given, the second expression must be another exception class or instance", which would exclude None.
Library manual, Ch 5. Built-in Exceptions, says
'''
When raising a new exception (rather than using a bare raise to re-raise the exception currently being handled), the implicit exception context can be supplemented with an explicit cause by using from with raise:
raise new_exc from original_exc
The expression following from must be an exception or None. It will be set as __cause__ on the raised exception. Setting __cause__ also implicitly sets the __suppress_context__ attribute to True, so that using raise new_exc from None effectively replaces the old exception with the new one for display purposes (e.g. converting KeyError to AttributeError, while leaving the old exception available in __context__ for introspection when debugging.
'''
I am not sure how much should be copied over, but None should be at least mentioned and perhaps there should be a cross-reference.
I am also not sure how much applies to 3.2, but there is no version-added or -changed note with the above.

As Terry notes, the various pieces of "from None" documentation should also have a nearby directive like:
.. versionchanged: 3.3
 :const:`None` permitted as ``Y`` in ``raise X from Y`` 
.. versionadded: 3.3
 The ``__suppress_context__`` attribute to suppress automatic display of the exception context

We have added the from None to the documentation with a explanation and some example code.

The patch should add something to the "The from clause is used for exception..." paragraph, to state that None is also allowed.
It also adds things in a confusing order. I think the new example should go below other examples, and the changedversion and addedversion directives should be the last thing in the section.

Hi,
As suggested by Petri,I have made some changes.
Please review the attached patch.Any comments and feedback are welcome.

Patch with some corrections.
Please review the patch attached.

The patch doesn't apply cleanly on 3.4 or default.

I have attached a patch for 3.4, based on the patch submitted by Nitika Agarwal. The main difference is that I think it's better to be explicit and show a separate example of `raise X from None`.
I will submit a patch for later versions as well.

OK, it seems that patch applies cleanly to 3.5 and 3.6.

Re-uploaded the patch without the typo.

reuploaded thomir's patch issue17188_3.4.patch as is.
I take no credit for this.

Would any of the original authors be able to prepare a PR for this? Thanks.

New changeset 763557eac06ba60d7c5133e4f80df8870d8f917e by terryjreedy (csabella) in branch 'master':
bpo-17188: DOC: Document 'from None' in raise statement (#1671)
https://github.com/python/cpython/commit/763557eac06ba60d7c5133e4f80df8870d8f917e

The double listing seems to be a glitch.
Either someone else does backport or online doc change waits until I can do it.

New changeset 00b381b9a7b6b15350d1dcf7c688bf808cbf0ebb by Mariatta (csabella) in branch '3.6':
bpo-17188: DOC: Document 'from None' in raise statement (GH-1671) (GH-1867)
https://github.com/python/cpython/commit/00b381b9a7b6b15350d1dcf7c688bf808cbf0ebb

Patch has been applied to 3.7 and 3.6.
Thanks everyone :)

Seems periods at the ends of sentences are missed.

New changeset 9efad1e5aef32a6d8ca288793e8ee6df8782f615 by Mariatta in branch 'master':
bpo-17188: add missing periods at the end of sentences (GH-1875)
https://github.com/python/cpython/commit/9efad1e5aef32a6d8ca288793e8ee6df8782f615

New changeset 60b257b01ca497d7a556e3f526704aa1b923d1ac by Mariatta in branch '3.6':
bpo-17188: add missing periods at the end of sentences (GH-1875) (GH-1876)
https://github.com/python/cpython/commit/60b257b01ca497d7a556e3f526704aa1b923d1ac

Thanks Serhiy.
I added the missing periods.