From: Georg Brandl <georg@python.org>
Date: Fri, 2 Apr 2010 08:39:09 +0000 (+0000)
Subject: #2768: add a note on how to get a file descriptor.
X-Git-Tag: v2.7b1~153
X-Git-Url: https://granicus.if.org/sourcecode?a=commitdiff_plain;h=49b9192b12ab203bf6c1ec2e29f5b3d8ed3df684;p=python

#2768: add a note on how to get a file descriptor.
---

diff --git a/Doc/library/os.rst b/Doc/library/os.rst
index 43d029a93f..b4e39a425d 100644
--- a/Doc/library/os.rst
+++ b/Doc/library/os.rst
@@ -513,6 +513,10 @@ process will then be assigned 3, 4, 5, and so forth.  The name "file descriptor"
 is slightly deceptive; on Unix platforms, sockets and pipes are also referenced
 by file descriptors.
 
+The :meth:`~file.fileno` method can be used to obtain the file descriptor
+associated with a file object when required.  Note that using the file
+descriptor directly will bypass the file object methods, ignoring aspects such
+as internal buffering of data.
 
 .. function:: close(fd)