Re: [PATCH] stty doc enhancements

[Pádraig Brady]

address@hidden wrote:
> Well, OK then.
> 
> PB> I think we can imply a computer is involved?
> PB> I was worried that the more verbose mentioning of both
> PB> the terminal and computer would suggest that stty
> PB> was restricted to remote serial terminals.

I'm going to push the attached soon

cheers,
Pádraig

>From 8a0d51dc9997fa8cbb6eb883979ed9749bddac03 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 <address@hidden>
---
 doc/coreutils.texi |    8 ++++++--
 1 files changed, 6 insertions(+), 2 deletions(-)

diff --git a/doc/coreutils.texi b/doc/coreutils.texi
index bbc2710..3c3b74a 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 no ilcuc is implemented, as one would not be able to issue
+almost any (lowercase) Unix command, after invoking it.
 
 @item ixany
 @opindex ixany
@@ -12005,6 +12007,7 @@ when the input buffer is full.  address@hidden  May be 
negated.
 
 @node Output
 @subsection Output settings
+These settings control operations on data sent to the terminal.
 
 @cindex output settings
 These arguments specify output-related operations.
@@ -12018,7 +12021,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 no ouclc is currently implemented.)
 
 @item ocrnl
 @opindex ocrnl
@@ -12271,6 +12274,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