[issue8519] [patch] doc: termios and ioctl reference links
Changes by anatoly techtonik techto...@gmail.com: -- nosy: +d...@python ___ Python tracker rep...@bugs.python.org http://bugs.python.org/issue8519 ___ ___ Python-bugs-list mailing list Unsubscribe: http://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com
[issue8519] [patch] doc: termios and ioctl reference links
New submission from anatoly techtonik techto...@gmail.com: The patch adds link to reference with various flags for termios functions and fcntl.ioctl call. -- assignee: georg.brandl components: Documentation files: .reference-termios-specification-for-flags.diff keywords: patch messages: 104094 nosy: georg.brandl, techtonik severity: normal status: open title: [patch] doc: termios and ioctl reference links versions: Python 2.7 Added file: http://bugs.python.org/file17068/.reference-termios-specification-for-flags.diff ___ Python tracker rep...@bugs.python.org http://bugs.python.org/issue8519 ___ ___ Python-bugs-list mailing list Unsubscribe: http://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com
[issue8519] [patch] doc: termios and ioctl reference links
Éric Araujo mer...@netwok.org added the comment: 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 -- nosy: +merwok ___ Python tracker rep...@bugs.python.org http://bugs.python.org/issue8519 ___ ___ Python-bugs-list mailing list Unsubscribe: http://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com
[issue8519] [patch] doc: termios and ioctl reference links
Georg Brandl ge...@python.org added the comment: 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. -- ___ Python tracker rep...@bugs.python.org http://bugs.python.org/issue8519 ___ ___ Python-bugs-list mailing list Unsubscribe: http://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com
[issue8519] [patch] doc: termios and ioctl reference links
anatoly techtonik techto...@gmail.com added the comment: É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. -- Added file: http://bugs.python.org/file17069/8519.reference-termios-specification-for-flags.diff ___ Python tracker rep...@bugs.python.org http://bugs.python.org/issue8519 ___ ___ Python-bugs-list mailing list Unsubscribe: http://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com
[issue8519] [patch] doc: termios and ioctl reference links
Georg Brandl ge...@python.org added the comment: 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. -- ___ Python tracker rep...@bugs.python.org http://bugs.python.org/issue8519 ___ ___ Python-bugs-list mailing list Unsubscribe: http://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com
[issue8519] [patch] doc: termios and ioctl reference links
anatoly techtonik techto...@gmail.com added the comment: 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. -- ___ Python tracker rep...@bugs.python.org http://bugs.python.org/issue8519 ___ ___ Python-bugs-list mailing list Unsubscribe: http://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com