[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: while True: ... pass

[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 Python code - it is for illustrative purposes only while

[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 rep...@bugs.python.org http

[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