[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
Re: [PATCH 04/17] man/curs_add{,_w}ch.3x: Relocate material.
From: |
Thomas Dickey |
Subject: |
Re: [PATCH 04/17] man/curs_add{,_w}ch.3x: Relocate material. |
Date: |
Sat, 16 Mar 2024 15:34:09 -0400 |
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