[docs] [issue16802] fileno argument to socket.socket() undocumented

[Henrik Heimbuerger]

Henrik Heimbuerger added the comment:

Here's a suggestion for a documentation addition. Comments on tone and content are welcome, and I'm willing to update it and submit modified patch files.

This adds the following note:
      If a file descriptor *fileno* is specified, the other arguments
      are ignored and and the socket with this file descriptor is returned. Unlike
      :meth:`fromfd`, this does not cause a duplication of the file descriptor
      and therefore supports the special case of closing detached socket handles
      on Windows using ``socket.socket(fileno=handle).close()``.

----------
keywords: +patch
nosy: +hheimbuerger
Added file: http://bugs.python.org/file29195/issue16802.diff

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