[issue21777] Separate out documentation of binary sequence methods

[Nick Coghlan]

Nick Coghlan added the comment:

OK, I've completed the initial pass through all the methods. Remaining items:

* add back the guarantees where str will return the same object, add those guarantees for bytes where applicable
* address the review comments from Zach and Ezio

There are a couple of review comments about removing duplication that I'd like to skip addressing for now. I think they're reasonable ideas, but I also think it's a lot easier to go wrong with DRY in docs than it is in code. Indeed, this whole matter of not documenting the bytes behaviour in the first place was a matter of assuming folks could just infer the binary behaviour from the text behaviour.

----------
Added file: http://bugs.python.org/file36101/separate_binary_sequence_docs_v4.diff

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