R. David Murray added the comment:
To be clear: this was/is the python2 documentation style. In python3 we've
switched to using keyword argument notation in functions that support
specifying optional arguments via keyword (which is many more of the C
functions than in python2).
--
no
Berker Peksag added the comment:
Thanks for the report, but the signature is correct.
>From https://docs.python.org/devguide/documenting.html#information-units
"The signature should include the parameters, enclosing optional parameters
in brackets."
See also http://sphinx-doc.org/domains.
New submission from Roy Smith:
At https://docs.python.org/2/library/hmac.html, hmac.new() is shown as
hmac.new(key[, msg[, digestmod]])
This implies that digestmod can only be given if msg is given. This is
incorrect. Either can be given without the other.
--
assignee: docs@python
c