Message323426
I think this was an attempt to specify a positional-only parameter (by using square brackets), and include a default value in the signature. The usual approach in this situation is to use square brackets, but only mention the default value in the text:
control(changelist, max_events[, timeout])
. . .
The default for "timeout" is None, to wait forever.
In Issue 13386 Ezio suggested against showing both square brackets and a default value, and I agree.
Berker: your "select" and "poll" cases all include the PEP 457 slash "/" notation, which was supposed to indicate positional-only parameters. See Issue 21314 about explaining this notation in the documentation somewhere. |
|
Date |
User |
Action |
Args |
2018-08-12 00:21:28 | martin.panter | set | recipients:
+ martin.panter, taleinat, a.badger, docs@python, berker.peksag, xtreak |
2018-08-12 00:21:27 | martin.panter | set | messageid: <1534033287.92.0.56676864532.issue34369@psf.upfronthosting.co.za> |
2018-08-12 00:21:27 | martin.panter | link | issue34369 messages |
2018-08-12 00:21:26 | martin.panter | create | |
|