[New-bugs-announce] [issue4669] bytes,join and bytearray.join not in manual; help for bytes.join is wrong.

[John Machin]

New submission from John Machin <sjmachin at users.sourceforge.net>:

These methods are parallel to str.join, seem to work as expected, and
have "help" entries. However there is nothing in the Library Reference
Manual about them.

>>> help(bytearray.join)
Help on method_descriptor:

join(...)
    B.join(iterable_of_bytes) -> bytearray

    Concatenate any number of bytes/bytearray objects, with B
    in between each pair, and return the result as a new bytearray.
### OK but could use an example.

>>> help(bytes.join)
Help on method_descriptor:

join(...)
    B.join(iterable_of_bytes) -> bytes

    Concatenate any number of bytes objects, with B in between each pair.
### Above sentence should read "Concatenate any number of
bytes/bytearray objects, with B in between each pair, and return the
result as a new bytes object."
    Example: b'.'.join([b'ab', b'pq', b'rs']) -> b'ab.pq.rs'.

----------
assignee: georg.brandl
components: Documentation
messages: 77849
nosy: georg.brandl, sjmachin
severity: normal
status: open
title: bytes,join and bytearray.join not in manual; help for bytes.join is wrong.
versions: Python 3.0, Python 3.1

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue4669>
_______________________________________