stty(1): provide details about interaction with job control

[kib]

Summary

PR:     266627

[emaste]

bin/stty/stty.1

104

"not prepared to handle it" or "not prepared for it"

[kib]

Grammar fix by emaste.
More man page updates.

[kib]

Fix patch generation

[jilles]

Since a similar effect can be obtained by having the shell ignore the signal via trap '' TTOU, I'm not sure it's a good idea to add an option for this.

An addition to the man page may be a good idea, though, since this effect of the disposition of SIGTTOU is listed in tcsetattr(3) but not in section 1 man pages.

bin/stty/stty.c

74

Because various operands to stty start with - and do not need --, every option added makes it more likely to get a conflict between an option and an operand. This suggests only adding options when it is extremely important, and perhaps using uppercase for options to make conflicts less likely.

[kib]

Drop -i addition.

[pauamma_gundo.com]

bin/stty/stty.1

621

622

623

Since it's a symbolic constant.

626

628

Make it clear we don't mean open(2) or fopen(3) flags.

630

637

[kib]

bin/stty/stty.1

628

It is open(2) O_NONBLOCK. It is mentioned earlier in the man page, in the description of -f.

[kib]

Pauamma comments

[pauamma_gundo.com]

One minor manual page nit, fixable on commit.

bin/stty/stty.1

630

Should be above the .Pp.

[kib]

bin/stty/stty.1

630

Should be .Nm

[kib]

Stray .Pp, should be .Nm