Re: [PATCH] stty doc enhancements

[Pádraig Brady]

thanks guys,

take 2 attached.

Pádraig.

>From 0fcf7301049a1db0268337e433932037cb8eac3c Mon Sep 17 00:00:00 2001
From: =?utf-8?q?P=C3=A1draig=20Brady?= <address@hidden>
Date: Tue, 23 Dec 2008 11:55:46 +0000
Subject: [PATCH] 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.
---
 THANKS             |    2 +-
 doc/coreutils.texi |    9 ++++++---
 2 files changed, 7 insertions(+), 4 deletions(-)

diff --git a/THANKS b/THANKS
index f74d4fb..d12626c 100644
--- a/THANKS
+++ b/THANKS
@@ -115,7 +115,7 @@ Cyril Bouthors                      address@hidden
 Dale Scheetz                        address@hidden
 Dameon G. Rogers                    address@hidden
 Dan Hagerty                         address@hidden
-Dan Jacobson                        http://www.geocities.com/jidani
+Dan Jacobson                        address@hidden
 Dan Pascu                           address@hidden
 Daniel Bergstrom                    address@hidden
 Daniel Dunbar                       address@hidden
diff --git a/doc/coreutils.texi b/doc/coreutils.texi
index bbc2710..9047925 100644
--- a/doc/coreutils.texi
+++ b/doc/coreutils.texi
@@ -11916,6 +11916,7 @@ Enable RTS/CTS flow control.  address@hidden  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.  address@hidden  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.  address@hidden  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.  address@hidden  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}.  address@hidden  May be negated.
+(Used for terminals with uppercase characters only.)
 
 @item crt
 @opindex crt
-- 
1.5.3.6