➜

This issue tracker has been migrated to GitHub, and is currently read-only.
For more information, see the GitHub FAQs in the Python's Developer Guide.

Author orsenthil
Recipients BreamoreBoy, Guido.van.Rossum, angad, docs@python, eric.araujo, georg.brandl, orsenthil, techtonik
Date 2016-01-20.06:39:00
SpamBayes Score -1.0
Marked as misclassified Yes
Message-id <1453271940.74.0.392971820614.issue8519@psf.upfronthosting.co.za>
In-reply-to
Content 
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.
History
Date User Action Args
2016-01-20 06:39:00orsenthilsetrecipients: + orsenthil, georg.brandl, techtonik, eric.araujo, docs@python, BreamoreBoy, Guido.van.Rossum, angad
2016-01-20 06:39:00orsenthilsetmessageid: <1453271940.74.0.392971820614.issue8519@psf.upfronthosting.co.za>
2016-01-20 06:39:00orsenthillinkissue8519 messages
2016-01-20 06:39:00orsenthilcreate