[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