Re: [Doc-SIG] Proposal: don't nest optional brackets
Sept. 25, 2008
10:08 a.m.
On Wed, September 24, 2008 10:21 am, A.M. Kuchling wrote:
.. method:: socket.recv_into(buffer[, nbytes[, flags]])
Straying slightly from the issue of keyword arguments, I'd like to point out that the nested brackets imply to me that the flags arg requires the nbytes arg to be present as well. Compare to your suggestions:
* Add '=' after parameters that can be provided as keywords: buffer=, [nbytes=, flags=] ...
* Write keyword arguments as unnested square brackets: (buffer[, nbytes][, flags])
Neither of those notations conveys a dependence of one argument on the other.
6407
Age (days ago)
6407
Last active (days ago)
0 comments
1 participants
participants (1)
-
Forest