[docs] [issue16701] Docs missing the behavior of += (in-place add) for lists.

[Martin Panter]

Martin Panter added the comment:

Here is a patch documenting the += and *= mutable sequence operations. Please review my wording.

These operations already seem to be tested, at least on the basic mutable sequences: see /Lib/test/list_tests.py, test_array, test_collections, test_bytes (tests bytearray).

The only other places that I thought might be missing augmented assignment were for sets, but there is no problem there: <https://docs.python.org/dev/library/stdtypes.html#set.update>.

However, there are other operations that I think may be missing from this page of the documentation. But it might be better to handle those in a separate bug report. Some of this could build off the work in Issue 12067.

* Equality comparisons (mentioned for range and dict, but apparently not tuple, set, strings, etc)
* Ordering comparisons (not supported for range)
* min() and max() don’t really belong; maybe substitute with iter()

----------
keywords: +patch
nosy: +martin.panter
stage: needs patch -> patch review
versions: +Python 3.6
Added file: http://bugs.python.org/file40552/seq-inplace.patch

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