The patch adds link to reference with various flags for termios functions and fcntl.ioctl call.

Note that there can be any whitespace in reST markup, e.g. you can put a newline betweeen “`thing” and “<link>`_”, thus avoiding too long lines. I think you can put a newline in a “<link>” too, they will be removed.

Regards

The POSIX reference is OK; I'm hesitant to put a Linux-specific reference in though.  Also, ioctls are not limited to tty operations.  IMO a :manpage:`ioctl(2)` would suffice.

Éric, thanks, attached reStructured patch.

Georg, ioctl(2) is useless, because it doesn't contain the information people need in addition to Python manual, i.e. various examples (like how to get console size) and constants (like TIOCGWINSZ) that are hard to find otherwise.

ioctl(2) usually has "see also" entries that list the available ioctls, such as ioctl_list on linux.

If you want to link to examples like getting console size, the manpage isn't very helpful either, since you have to figure out how exactly to call ioctl.  Linking to a pertinent recipe e.g. in the Cookbook, or including the example right there makes much more sense.

I do not mind if you include a better link with ioctl constants explained or have ideas for examples. I hope you agree the ioctl(2) man page contains much less useful information than http://www.kernel.org/doc/man-pages/online/pages/man4/tty_ioctl.4.html

But I see your point that ioctl is not used solely for tty. Perhaps there could be two links. Removing tty_ioctl constants reference is not an option for me, because the whole stuff is complicated and for me it was very hard to find these console functions for Linux. There is no other way to work with Linux console from Python.

My understanding is that we can't use the patches as the originator has never signed the CLA.  Am I correct or does this only apply to code, or what?

In this case I think there is no legal issue. All you have to do is take the link from the patch and come up with a fresh patch of your own.

(However I think Georg's objection against a Linux-specific link stands. You can probably find a POSIX link that would be acceptable.)

Created a patch for this. Added POSIX links for fcntl, ioctl and termios. Let me know if I am missing anything.

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.

+1 for using the manpage directives.

New changeset f53a0566a290 by Senthil Kumaran in branch '3.5':
issue8519 - Reference termios and ioctl manual pages in the library documentation.
https://hg.python.org/cpython/rev/f53a0566a290

New changeset 8db146bec24b by Senthil Kumaran in branch 'default':
[merge from 3.5] - issue8519 - Reference termios and ioctl manual pages in the library documentation.
https://hg.python.org/cpython/rev/8db146bec24b

New changeset 55886a6aed4b by Senthil Kumaran in branch '2.7':
[backport to 2.7] - issue8519 - Reference termios and ioctl manual pages in the library documentation.
https://hg.python.org/cpython/rev/55886a6aed4b

Thanks Angad and Anatoly for the patches discussions.
Thank you Berker for review.

Made the changes in all active versions of python. Let this issue reset in peace.