From 1a01ebc41cbbfc127865f82656879a58c2560543 Mon Sep 17 00:00:00 2001 From: Petri Lehtinen Date: Thu, 24 May 2012 21:44:07 +0300 Subject: #14863: Update the documentation of os.fdopen() There's no bufsize argument anymore, and os.fdopen() is only a very thin wrapper around open() anymore. Change the documentation to reflect that. --- Doc/library/os.rst | 20 +++++--------------- Misc/NEWS | 3 +++ 2 files changed, 8 insertions(+), 15 deletions(-) diff --git a/Doc/library/os.rst b/Doc/library/os.rst index 3f43338..5991e29 100644 --- a/Doc/library/os.rst +++ b/Doc/library/os.rst @@ -545,22 +545,12 @@ File Object Creation These functions create new :term:`file objects `. (See also :func:`open`.) -.. function:: fdopen(fd[, mode[, bufsize]]) +.. function:: fdopen(fd, *args, **kwargs) - .. index:: single: I/O control; buffering - - Return an open file object connected to the file descriptor *fd*. The *mode* - and *bufsize* arguments have the same meaning as the corresponding arguments to - the built-in :func:`open` function. - - When specified, the *mode* argument must start with one of the letters - ``'r'``, ``'w'``, or ``'a'``, otherwise a :exc:`ValueError` is raised. - - On Unix, when the *mode* argument starts with ``'a'``, the *O_APPEND* flag is - set on the file descriptor (which the :c:func:`fdopen` implementation already - does on most platforms). - - Availability: Unix, Windows. + Return an open file object connected to the file descriptor *fd*. + This is an alias of :func:`open` and accepts the same arguments. + The only difference is that the first argument of :func:`fdopen` + must always be an integer. .. _os-fd-ops: diff --git a/Misc/NEWS b/Misc/NEWS index d9b8b5c..efec480 100644 --- a/Misc/NEWS +++ b/Misc/NEWS @@ -67,6 +67,9 @@ Core and Builtins Library ------- +- Issue #14863: Update the documentation of os.fdopen() to reflect the + fact that it's only a thin wrapper around open() anymore. + - Issue #14036: Add an additional check to validate that port in urlparse does not go in illegal range and returns None. -- cgit v0.12