[docs] comma after leading optional argument is after bracket in docs (issue 15831)

ezio.melotti at gmail.com ezio.melotti at gmail.com
Wed Sep 5 14:15:29 CEST 2012


http://bugs.python.org/review/15831/diff/5943/Doc/library/functions.rst
File Doc/library/functions.rst (right):

http://bugs.python.org/review/15831/diff/5943/Doc/library/functions.rst#newcode983
Doc/library/functions.rst:983: .. function:: print(*objects, sep=' ',
end='\\n', file=sys.stdout, flush=False)
Why the * is missing here?

http://bugs.python.org/review/15831/diff/5943/Doc/library/http.client.rst
File Doc/library/http.client.rst (right):

http://bugs.python.org/review/15831/diff/5943/Doc/library/http.client.rst#newcode31
Doc/library/http.client.rst:31: source_address=None)
This signature is not too nice, but I'm not sure how it could be
improved.  Is strict a bool?  Maybe using
timeout=socket.getdefaulttimeout() might be ok (assuming that's what it
uses), or if it's set to None or something similar and then re-set to
the actual value you could use None in the signature and describe it in
prose later.

http://bugs.python.org/review/15831/


More information about the docs mailing list