This issue tracker has been migrated to GitHub, and is currently read-only.
For more information, see the GitHub FAQs in the Python's Developer Guide.

Author steven.daprano
Recipients Maik Ro, docs@python, steven.daprano
Date 2017-12-13.11:06:50
SpamBayes Score -1.0
Marked as misclassified Yes
Message-id <1513163210.2.0.213398074469.issue32301@psf.upfronthosting.co.za>
In-reply-to
Content
The given version is correct: the comma is only required if the initializer is given. Your suggested version 

    typecode, [initializer]

implies that the comma is always required whether the initializer is given or not.

If we want to be absolutely pedantic, we could write:

    .. class:: array(typecode[, [initializer]])

as trailing commas are legal in function calls. But I don't think that makes for good documentation.
History
Date User Action Args
2017-12-13 11:06:50steven.dapranosetrecipients: + steven.daprano, docs@python, Maik Ro
2017-12-13 11:06:50steven.dapranosetmessageid: <1513163210.2.0.213398074469.issue32301@psf.upfronthosting.co.za>
2017-12-13 11:06:50steven.dapranolinkissue32301 messages
2017-12-13 11:06:50steven.dapranocreate