This issue tracker has been migrated to GitHub, and is currently read-only.
For more information, see the GitHub FAQs in the Python's Developer Guide.

Author Lorem Ipsum
Recipients Lorem Ipsum, docs@python
Date 2017-08-09.02:37:54
SpamBayes Score -1.0
Marked as misclassified Yes
Message-id <1502246275.38.0.890057309211.issue31152@psf.upfronthosting.co.za>
In-reply-to
Content
Python 3.5.4 Tutorial Section 8.5. User-defined Exceptions Paragraph 2 (https://docs.python.org/3.5/tutorial/errors.html#user-defined-exceptions) states [emphasis mine]:

"When creating a module that can raise several distinct errors, a common practice is to create a base class for exceptions defined by that module, and SUBCLASS THAT TO create specific exception classes for different error conditions:"

The use of 'subclass' as a verb when it has not been used so prior is confusing, especially to beginners.  The concept of a class is not formally covered until Section 9 and up until this point in the tutorial, 'class' has been used as a noun.  When read with 'subclass' as a noun, the sentence is nonsensical. It may also be that the comma which precedes 'and' is not proper usage. 

Suggested improvement: change "subclass that to create specific classes for..." to "then create specific exception subclasses for..."

"When creating a module that can raise several distinct errors, a common practice is to create a base class for exceptions defined by that module, and then create specific exception subclasses for different error conditions:"
History
Date User Action Args
2017-08-09 02:37:55Lorem Ipsumsetrecipients: + Lorem Ipsum, docs@python
2017-08-09 02:37:55Lorem Ipsumsetmessageid: <1502246275.38.0.890057309211.issue31152@psf.upfronthosting.co.za>
2017-08-09 02:37:55Lorem Ipsumlinkissue31152 messages
2017-08-09 02:37:54Lorem Ipsumcreate