Re: [PATCH 04/17] man/curs_add{,_w}ch.3x: Relocate material.

[Thomas Dickey]

On Wed, Mar 13, 2024 at 01:09:59PM -0500, G. Branden Robinson wrote:
> Move a paragraph so it no longer appears to fall under the "TABSIZE"
> subsection heading, with which it has nothing to do.
> ---
>  man/curs_add_wch.3x | 12 ++++++------
>  man/curs_addch.3x   | 12 ++++++------
>  2 files changed, 12 insertions(+), 12 deletions(-)
> 
> diff --git a/man/curs_add_wch.3x b/man/curs_add_wch.3x
> index 01307815a..8fda68c84 100644
> --- a/man/curs_add_wch.3x
> +++ b/man/curs_add_wch.3x
> @@ -325,6 +325,12 @@ .SH NOTES
>  .SH PORTABILITY
>  These functions are described in the XSI Curses standard, Issue 4.
>  The defaults specified for line-drawing characters apply in the POSIX locale.
> +.PP
> +If \fIwch\fP is a carriage return,
> +.I curses
> +moves the cursor to the beginning of the current row of the window.
> +This is true of other implementations,
> +but is not documented.

Actually it is documented.  In the description of add_wch, it notes:

       •   If the character part of wch is a tab, newline, backspace or  other
           control character, the window is updated and the cursor moves as if
           addch were called.

and addch says

       If ch is a tab, newline, carriage return or backspace,  the  cursor  is
       moved appropriately within the window:

       ...

       •   Carriage return moves the cursor to the window left margin  on  the
           current line.

The addch description is referred to in several manpages,
to reduce repetition.

The X/Open Curses pages put that sort of thing in a separate location, e.g.,

https://pubs.opengroup.org/onlinepubs/7908799/xcurses/intov.html#tag_001_004_003

...which would be awkward for a manpage
(unless one gives in and puts everything in the same manpage).

That reminds me of the time that I got mail from someone who thought it
was inconvenient to have dialog split into several source files...

-- 
Thomas E. Dickey <dickey@invisible-island.net>
https://invisible-island.net

signature.asc
Description: PGP signature