doc: stty: Clarification of some input and output settings

* doc/coreutils.texi (stty invocation): Clarify any
ambiguity in regard to the direction of input and output settings.
Add some notes on the case changing settings.
Most of the text was supplied by Dan Jacobson.

diff --git a/THANKS b/THANKS
index f74d4fb48508518fa5083db87893f1fecd1a40f0..d12626ca513f7285d5909293722558cfb1c2cee3 100644 (file)
--- a/THANKS
+++ b/THANKS
@@ -115,7 +115,7 @@ Cyril Bouthors                      cyril@bouthors.org
 Dale Scheetz                        dwarf@polaris.net
 Dameon G. Rogers                    dgr03@uark.edu
 Dan Hagerty                         hag@gnu.ai.it.edu
-Dan Jacobson                        http://www.geocities.com/jidani
+Dan Jacobson                        jidanni@jidanni.org
 Dan Pascu                           dan@services.iiruc.ro
 Daniel Bergstrom                    noa@melody.se
 Daniel Dunbar                       ddunbar@stanford.edu

diff --git a/doc/coreutils.texi b/doc/coreutils.texi
index bbc2710bbee7ca230777744d2163c72da96718da..9047925e3117a770bd3dfe87f972db7dc65e4afa 100644 (file)
--- a/doc/coreutils.texi
+++ b/doc/coreutils.texi
@@ -11916,6 +11916,7 @@ Enable RTS/CTS flow control.  Non-@acronym{POSIX}.  May be negated.
 @subsection Input settings
 
 @cindex input settings
+These settings control operations on data received from the terminal.
 
 @table @samp
 @item ignbrk
@@ -11988,7 +11989,8 @@ empty again.  May be negated.
 @opindex iuclc
 @cindex uppercase, translating to lowercase
 Translate uppercase characters to lowercase.  Non-@acronym{POSIX}.  May be
-negated.
+negated. Note ilcuc is not implemented, as one would not be able to issue
+almost any (lowercase) Unix command, after invoking it.
 
 @item ixany
 @opindex ixany
@@ -12007,7 +12009,7 @@ when the input buffer is full.  Non-@acronym{POSIX}.  May be negated.
 @subsection Output settings
 
 @cindex output settings
-These arguments specify output-related operations.
+These settings control operations on data sent to the terminal.
 
 @table @samp
 @item opost
@@ -12018,7 +12020,7 @@ Postprocess output.  May be negated.
 @opindex olcuc
 @cindex lowercase, translating to output
 Translate lowercase characters to uppercase.  Non-@acronym{POSIX}.  May be
-negated.
+negated. (Note ouclc is not currently implemented.)
 
 @item ocrnl
 @opindex ocrnl
@@ -12271,6 +12273,7 @@ as @code{tab3}.
 @opindex lcase
 @opindex LCASE
 Same as @code{xcase iuclc olcuc}.  Non-@acronym{POSIX}.  May be negated.
+(Used for terminals with uppercase characters only.)
 
 @item crt
 @opindex crt