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.