[issue11310] Document byte[s|array]() and byte[s|array](count) in docstrings
New submission from Terry J. Reedy <tjreedy@udel.edu>: The entry for bytearray(source...) says " The optional source parameter can be used to initialize the array in a few different ways: ... If it is an integer, the array will have that size and will be initialized with null bytes. ... Without an argument, an array of size 0 is created. " [integer must be non-negative -- patch adds this] The entry for bytes(source...) refers back to the bytearray entry. The docstrings for bytes and bytearray omit both possibilities. Attached is a possible patch to include them. ---------- assignee: docs@python components: Documentation files: zbytes.diff keywords: patch messages: 129299 nosy: docs@python, terry.reedy priority: normal severity: normal status: open title: Document byte[s|array]() and byte[s|array](count) in docstrings versions: Python 3.2, Python 3.3 Added file: http://bugs.python.org/file20877/zbytes.diff _______________________________________ Python tracker <report@bugs.python.org> <http://bugs.python.org/issue11310> _______________________________________
Éric Araujo <merwok@netwok.org> added the comment: I think you could just go ahead and commit your patch. I don’t remember if the reST docs were changed recently-ish or if it’s still an open bug, so you may want to check that the new docstrings matches the doc. ---------- nosy: +eric.araujo versions: +Python 2.7 _______________________________________ Python tracker <report@bugs.python.org> <http://bugs.python.org/issue11310> _______________________________________
R. David Murray <rdmurray@bitdance.com> added the comment: Duplicate of issue 11231. ---------- nosy: +r.david.murray resolution: -> duplicate stage: -> committed/rejected status: open -> closed superseder: -> bytes() constructor is not correctly documented _______________________________________ Python tracker <report@bugs.python.org> <http://bugs.python.org/issue11310> _______________________________________
participants (3)
-
R. David Murray
-
Terry J. Reedy
-
Éric Araujo