[issue39108] Documentation for "random.gauss" vs "random.normalvariate" is lacking

2019-12-20 Thread Charles Newey
New submission from Charles Newey : The Python 3 documentation for the "random" module mentions two possible ways to generate a random variate drawn from a normal distribution - "random.gauss" and "random.normalvariate" (see: https://docs.python.org/3/library/ra

[issue22106] Python 2 docs 'control flow/pass' section contains bad example

2014-07-30 Thread Charles Newey
Charles Newey added the comment: @David I have no idea either (no having written much of that sort of code myself either), but that looks more sensible. I'm just nitpicking really, anyway. -- ___ Python tracker <http://bugs.python.org/is

[issue22106] Python 2 docs 'control flow/pass' section contains bad example

2014-07-30 Thread Charles Newey
Charles Newey added the comment: Your point about using "pass" with the "with" statement sounds like a better example than using "pass" in a loop. Perhaps even something like adding a note to the example to clarify it: """ # Don't use this in

[issue22106] Python 2 docs 'control flow/pass' section contains bad example

2014-07-30 Thread Charles Newey
New submission from Charles Newey: URL: https://docs.python.org/2/tutorial/controlflow.html#pass-statements Quoted verbatim: """ The pass statement does nothing. It can be used when a statement is required syntactically but the program requires no action. For example: >