Re: [PATCH] stty doc enhancements

[Pádraig Brady]

The clarifications are worthwhile though a little verbose.
comments below..

address@hidden wrote:
> ---
>  doc/coreutils.texi |   12 +++++++++---
>  1 files changed, 9 insertions(+), 3 deletions(-)
> 
> diff --git a/doc/coreutils.texi b/doc/coreutils.texi
> index 49aa16d..020dc51 100644
> --- a/doc/coreutils.texi
> +++ b/doc/coreutils.texi
> @@ -11919,6 +11919,8 @@ Enable RTS/CTS flow control.  address@hidden  May be 
> negated.
>  @subsection Input settings
>  
>  @cindex input settings
> +These arguments specify input-related operations, i.e., bytes sent
> +from your terminal to the computer are affected by them.

How about:

These settings control operations on data received from the terminal.

>  
>  @table @samp
>  @item ignbrk
> @@ -11991,7 +11993,9 @@ 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 currently implemented, probably because one
> +would not be able to use any more Unix commands, which are almost all
> +lower case, after invoking it.)

How about:

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
> @@ -12010,7 +12014,8 @@ when the input buffer is full.  address@hidden  May 
> be negated.
>  @subsection Output settings
>  
>  @cindex output settings
> -These arguments specify output-related operations.
> +These arguments specify output-related operations, i.e., bytes sent
> +from the computer to your terminal are affected by them.

How about:

These settings control operations on data sent to the terminal.

>  
>  @table @samp
>  @item opost
> @@ -12021,7 +12026,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
> @@ -12274,6 +12279,7 @@ as @code{tab3}.
>  @opindex lcase
>  @opindex LCASE
>  Same as @code{xcase iuclc olcuc}.  address@hidden  May be negated.
> +(Note no ucase has been implemented.)

How about just saying:
(Used for terminals with uppercase characters only.)

thanks for persevering with this,
Pádraig.