Issue 1444104: os.open() Documentation - Python tracker (original) (raw)

Hi,

I think the note in the docu could be improved:

"""To read a ``file object'' returned by the built-in function open() or by popen() or fdopen(), or sys.stdin, use its read() or readline() methods."""

(I think) a better note:

"""To read a ``file object'' returned by the built-in function open(), popen(), fdopen() or sys.stdin, use its read() or readline() methods. You can convert the file descriptor returned by os.open() to a file object with [LINK os.fdopen()]"""

The same note is used for os.write().

At os.open() there should be a link to os.fdopen(), too.