[issue20582] socket.getnameinfo() does not document flags

Demian Brecht report at bugs.python.org
Sun Jan 20 23:51:43 EST 2019


Demian Brecht <demianbrecht at gmail.com> added the comment:

What if the docs for socket functions that took system-level flag parameters had links to relevant online man pages? I don't think a single entry at the top of the page would be optimal. I know that I tend to skip the preamble and just go directly to the function I'm interested in.

I know that it's not a perfect solution because there's a good chance of those links going stale. I'm also relatively sure that we wouldn't want to have an exhaustive list. However, I think in this instance that /something/ would be better than nothing. Even if the link is stale or the target OS isn't included, it would give the reader a place to start, which is currently lacking.

----------

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue20582>
_______________________________________


More information about the Python-bugs-list mailing list