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

2014-01-18 Thread Nikolaus Rath
Nikolaus Rath added the comment: Indeed, this makes most sense. I didn't know that glossary entry existed. I have attached an updated patch. Thanks for reviewing! -- Added file: http://bugs.python.org/file33533/issue17811_rev2.patch ___ Python

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

2014-01-18 Thread Nikolaus Rath
Changes by Nikolaus Rath nikol...@rath.org: -- versions: -Python 3.5 ___ Python tracker rep...@bugs.python.org http://bugs.python.org/issue17811 ___ ___ Python-bugs-list

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

2014-01-18 Thread Roundup Robot
Roundup Robot added the comment: New changeset 8b413f813a13 by Benjamin Peterson in branch '3.3': improve description of buffers argument for readv/writev (closes #17811) http://hg.python.org/cpython/rev/8b413f813a13 New changeset 4d56006133f1 by Benjamin Peterson in branch 'default': merge 3.3

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

2014-01-17 Thread Ethan Furman
Changes by Ethan Furman et...@stoneleaf.us: -- nosy: +ethan.furman ___ Python tracker rep...@bugs.python.org http://bugs.python.org/issue17811 ___ ___ Python-bugs-list

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

2014-01-17 Thread Benjamin Peterson
Benjamin Peterson added the comment: IMO, it should just refer to the glossary entry for bytes-like object. -- nosy: +benjamin.peterson ___ Python tracker rep...@bugs.python.org http://bugs.python.org/issue17811

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

2014-01-07 Thread Nikolaus Rath
Nikolaus Rath added the comment: I have attached a patch that takes into account your comments. Would this be suitable for inclusion? -- keywords: +patch Added file: http://bugs.python.org/file33362/issue17811.diff ___ Python tracker

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

2013-04-21 Thread Nikolaus Rath
New submission from Nikolaus Rath: The os.writev and os.readv functions are currently documented as: os.writev(fd, buffers) Write the contents of buffers to file descriptor fd, where buffers is an arbitrary sequence of buffers. Returns the total number of bytes written. os.readv(fd,

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

2013-04-21 Thread Nikolaus Rath
Nikolaus Rath added the comment: Here's a first attempt at improvement based on my guess: os.writev(fd, buffers) Write the contents of buffers to file descriptor fd, where buffers is an arbitrary sequence of buffers. In this context, a buffer may be any Python object that provides a

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

2013-04-21 Thread 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

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

2013-04-21 Thread Nikolaus Rath
Nikolaus Rath added the comment: What section do you mean? bytearray is not mentioned anywhere in http://docs.python.org/3.4/library/os.html. I think the problem with just linking to the C API section is that it doesn't help people that are only using pure Python. You can't look at a Python