Senthil Kumaran added the comment: I followed the previous discussions and reviewed the patch. With respect to the patch, I see few drawbacks in providing links to references like this:
`fcntl <http://pubs.opengroup.org/onlinepubs/009695399/basedefs/fcntl.h.html>`_ `ioctl <http://pubs.opengroup.org/onlinepubs/009695399/functions/ioctl.html>`_ `the POSIX specification +<http://pubs.opengroup.org/onlinepubs/9699919799/basedefs/termios.h.html>`_ these URLs can quickly become outdated and it will be an unnecessary detail for us to maintain. Instead, I suggest we have references like :manpage:`fcntl(2)`, :manpage:`ioctl(2)` and :manpage:`termios(2)`, a supported directive by sphinx, so that users can quickly search for those and land up on relevant and latest documentation. ---------- nosy: +orsenthil _______________________________________ Python tracker <rep...@bugs.python.org> <http://bugs.python.org/issue8519> _______________________________________ _______________________________________________ Python-bugs-list mailing list Unsubscribe: https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com
