[issue21777] Separate out documentation of binary sequence methods
Nick Coghlan
report at bugs.python.org
Mon Jul 14 04:00:39 CEST 2014
Nick Coghlan added the comment:
On 13 Jul 2014 18:39, "Marc-Andre Lemburg" <report at bugs.python.org> wrote:
>
>
> Marc-Andre Lemburg added the comment:
>
> Why are you removing guarantees like these from the str docs:
>
> "The original string is returned if *width* is less than or equal to
``len(s)``."
Because it's untrue for bytearray, and possible object reuse is a general
characteristic of immutability for str and bytes. If another implementation
makes a copy for some reason, it would still be considered "Python".
Since the sentence thus conveys no useful information, I removed it from
both the text and binary variants rather than coming up with appropriate
wording to indicate that the behaviour of returning a new reference to the
existing object when no content changes are needed doesn't apply to the
mutable bytearray.
>
> ?
>
> This doesn't seem to have anything to do with documenting bytes and
bytearrays.
>
> ----------
> nosy: +lemburg
>
> _______________________________________
> Python tracker <report at bugs.python.org>
> <http://bugs.python.org/issue21777>
> _______________________________________
----------
_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue21777>
_______________________________________
More information about the Python-bugs-list
mailing list