[issue27242] Make the docs for NotImplemented & NotImplementedError unambigous

2016-06-08 Thread Martin Panter
Martin Panter added the comment: I think the box about NotImplementedError needs indenting too. See the box for for a better example. -- ___ Python tracker

[issue27242] Make the docs for NotImplemented & NotImplementedError unambigous

2016-06-08 Thread Emanuel Barry
Emanuel Barry added the comment: Martin: yes, I plan to install Sphinx soon enough, so that I can build the docs. As for the notes part, I indented it exactly like it was indented for other existing notes boxes in the same file. I'll change that if needed though. -- __

[issue27242] Make the docs for NotImplemented & NotImplementedError unambigous

2016-06-07 Thread Martin Panter
Martin Panter added the comment: Emanuel, have you seen ? From my experience, install Sphinx, and then “make -C Doc/ html”. About the patch, I think the “.. note” boxes should be intended under the NotImplementedErr

[issue27242] Make the docs for NotImplemented & NotImplementedError unambigous

2016-06-07 Thread Emanuel Barry
Emanuel Barry added the comment: More tweaks after Ethan's comments. This is starting to get way outside of the realm of NotImplemented, but it still makes for a good reference to point confused users at. -- Added file: http://bugs.python.org/file43284/NotImplemented_exceptions_wordin

[issue27242] Make the docs for NotImplemented & NotImplementedError unambigous

2016-06-06 Thread Emanuel Barry
Emanuel Barry added the comment: New patch with small tweaks. Thanks Jelle for the comments! -- Added file: http://bugs.python.org/file43273/NotImplemented_exceptions_wording_3.patch ___ Python tracker ___

[issue27242] Make the docs for NotImplemented & NotImplementedError unambigous

2016-06-06 Thread Emanuel Barry
Emanuel Barry added the comment: Added further notes to `NotImplemented` and `NotImplementedError` to clearly state the differences between the two. I also added some more details to `TypeError` - I'm amazed at how little was described for such a common exception! Maybe I explained a bit too