[docs] [issue17811] Improve os.readv() and os.writev() documentation and docstring

[R. David Murray]

R. David Murray added the comment:

Well, the documentation is technically precise.  I'd even managed to forget that buffer objects existed in Python2 :)

As you observed, in Python3 a buffer is something that implements the buffer protocol.  What I would do is link the word 'buffer' to http://docs.python.org/3/c-api/buffer.html.  Perhaps mentioning bytes and bytearray as examples of read-only and writeable buffers would be worthwhile, but they are mentioned in the first paragraph of that section so it may not be necessary.

----------
nosy: +r.david.murray

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