Re: man 4 tty_ioctl fixes

Hi Марк

On 16 January 2015 at 12:28, Марк Коренберг [off-list ref] wrote:

2015-01-16 16:20 GMT+05:00 Michael Kerrisk (man-pages) [off-list ref]:

quoted

[CC restored]

Hello Марк

On 16 January 2015 at 12:05, Марк Коренберг [off-list ref] wrote:

quoted

EXTPROC is not documented (can be set on c_lflag in termios structure)
TIOCPKT_IOCTL is not documented (this value will appear when using
terminal in packet mode). Not sure if TIOCPKT_IOCTL will appear only
if EXTPROC is set.

I want you to dcument that constants, and behaviour that will be
changed when applying that termios.

I'll cut to the chase: I want *you* to do it. Why do you presume that
I should do it?

Since this letter is the form of reporting bug in man pages.

Making a bug report is fine (although your initial report was very
cryptic), but it is different from *solving* a bug. My time is
limited, and totally unpaid. I cannot solve all of the bug reports.

If you
know who can write CORRECT description of these constants -- it will
be nice.
I thought that you can write this description since, I think, you are
more expirienced developer than I. Also my English is not so good.

You make many useful reports of minor bugs, and these are appreciated,
Марк. It seems to me though, that maybe it's time to a bigger step:
fix a bigger documentation problem. How about it? (And if your English
text needs improving, I or someone else on the list might help.)

Thanks,

Michael

quoted

quoted

2015-01-16 15:36 GMT+05:00 Michael Kerrisk (man-pages) [off-list ref]:

quoted

Hello Марк.

What is the purpose of your report?

Thanks,

Michael


On 11 January 2015 at 20:58, Марк Коренберг [off-list ref] wrote:

quoted

$ egrep '[^A-Z0-9]EXTPROC' -r /usr/include
/usr/include/x86_64-linux-gnu/bits/termios.h:# define EXTPROC 0200000
/usr/include/asm-generic/termbits.h:#define EXTPROC 0200000
<-------- undocumented

$ fgrep TIOCPKT -r /usr/include
/usr/include/asm-generic/ioctls.h:#define TIOCPKT 0x5420
/usr/include/asm-generic/ioctls.h:#define TIOCPKT_DATA 0
/usr/include/asm-generic/ioctls.h:#define TIOCPKT_FLUSHREAD 1
/usr/include/asm-generic/ioctls.h:#define TIOCPKT_FLUSHWRITE 2
/usr/include/asm-generic/ioctls.h:#define TIOCPKT_STOP 4
/usr/include/asm-generic/ioctls.h:#define TIOCPKT_START 8
/usr/include/asm-generic/ioctls.h:#define TIOCPKT_NOSTOP 16
/usr/include/asm-generic/ioctls.h:#define TIOCPKT_DOSTOP 32
/usr/include/asm-generic/ioctls.h:#define TIOCPKT_IOCTL 64  <------ undocumented

Some information:

http://stackoverflow.com/questions/21641754/when-pty-pseudo-terminal-slave-fd-settings-are-changed-by-tcsetattr-how-ca
http://lists.gnu.org/archive/html/bug-readline/2011-01/msg00004.html

--
Michael Kerrisk
Linux man-pages maintainer; http://www.kernel.org/doc/man-pages/
Linux/UNIX System Programming Training: http://man7.org/training/

--
Segmentation fault

--
Michael Kerrisk
Linux man-pages maintainer; http://www.kernel.org/doc/man-pages/
Linux/UNIX System Programming Training: http://man7.org/training/

--
Segmentation fault

-- 
Michael Kerrisk
Linux man-pages maintainer; http://www.kernel.org/doc/man-pages/
Linux/UNIX System Programming Training: http://man7.org/training/
--
To unsubscribe from this list: send the line "unsubscribe linux-man" in
the body of a message to majordomo-u79uwXL29TY76Z2rM5mHXA@public.gmane.org
More majordomo info at  http://vger.kernel.org/majordomo-info.html