Éric Araujo <mer...@netwok.org> added the comment:

Your rewrite makes the text much clearer in my opinion. Here are some nits for 
you to grind, cheers :)

1) I’d say “using a bare ``except:``” and maybe add an index entry for “bare 
except” referring to that section, to make indexing and maybe googling find 
this.

2) To make the bad examples clearer, I would remove the second inline comment 
(“will be changed as soon as we run it”). The wording is confusing: Does that 
mean the code will be changed by Python at runtime? The text after this code 
example is clear enough, this comment doesn’t help.

3) “except catches all errors, including GeneratorExit which is not even an 
error”: Isn’t this confusing for beginners?

----------
nosy: +eric.araujo

_______________________________________
Python tracker <rep...@bugs.python.org>
<http://bugs.python.org/issue9608>
_______________________________________
_______________________________________________
Python-bugs-list mailing list
Unsubscribe: 
http://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

Reply via email to