ncurses 6.5 - patch 20240504

[ncurses.git] / man / curs_add_wch.3x

diff --git a/man/curs_add_wch.3x b/man/curs_add_wch.3x
index 70d849f1c3b662c6a0112cf9d15617aabc9b7888..d1eb9a311fc81ae718d564648c615a80b053b957 100644 (file)
--- a/man/curs_add_wch.3x
+++ b/man/curs_add_wch.3x
@@ -28,8 +28,8 @@
 .\" authorization.                                                           *
 .\"***************************************************************************
 .\"
 .\" authorization.                                                           *
 .\"***************************************************************************
 .\"

-.\" $Id: curs_add_wch.3x,v 1.53 2024/01/13 22:05:39 tom Exp $
-.TH curs_add_wch 3X 2024-01-13 "ncurses 6.4" "Library calls"
+.\" $Id: curs_add_wch.3x,v 1.62 2024/04/20 21:20:07 tom Exp $
+.TH curs_add_wch 3X 2024-04-20 "ncurses @NCURSES_MAJOR@.@NCURSES_MINOR@" "Library calls"

 .ie \n(.g \{\
 .ds `` \(lq
 .ds '' \(rq
 .ie \n(.g \{\
 .ds `` \(lq
 .ds '' \(rq


@@ -293,7 +293,7 @@ U+2550 BOX DRAWINGS DOUBLE HORIZONTAL
 .SH RETURN VALUE
 All routines return the integer \fBERR\fP upon failure and \fBOK\fP on success.
 .PP
 .SH RETURN VALUE
 All routines return the integer \fBERR\fP upon failure and \fBOK\fP on success.
 .PP

-X/Open does not define any error conditions.
+X/Open Curses does not specify any error conditions.

 This implementation returns an error
 .bP
 if the window pointer is null or
 This implementation returns an error
 .bP
 if the window pointer is null or


@@ -312,9 +312,11 @@ of bytes,
 or if it is not possible to add all of the resulting bytes in the window,
 an error is returned.
 .PP
 or if it is not possible to add all of the resulting bytes in the window,
 an error is returned.
 .PP

-Functions with a \*(``mv\*('' prefix first perform a cursor movement using
-\fBwmove\fP, and return an error if the position is outside the window,
-or if the window pointer is null.
+Functions prefixed with \*(``mv\*('' first perform cursor movement and
+fail if the position
+.RI ( y ,
+.IR x )
+is outside the window boundaries.

 .SH NOTES
 Note that
 \fBadd_wch\fP,
 .SH NOTES
 Note that
 \fBadd_wch\fP,


@@ -323,7 +325,7 @@ Note that
 \fBecho_wchar\fP
 may be macros.
 .SH PORTABILITY
 \fBecho_wchar\fP
 may be macros.
 .SH PORTABILITY

-These functions are described in the XSI Curses standard, Issue 4.
+These functions are described in X/Open Curses, Issue 4.

 The defaults specified for line-drawing characters apply in the POSIX locale.
 .SS "WACS Symbols"
 X/Open Curses makes it clear that the WACS_ symbols should be defined as
 The defaults specified for line-drawing characters apply in the POSIX locale.
 .SS "WACS Symbols"
 X/Open Curses makes it clear that the WACS_ symbols should be defined as


@@ -338,7 +340,7 @@ wide characters.
 The misdefined symbols are the arrows
 and other symbols which are not used for line-drawing.
 .PP
 The misdefined symbols are the arrows
 and other symbols which are not used for line-drawing.
 .PP

-X/Open Curses does not define symbols for thick- or double-lines.
+X/Open Curses does not specify symbols for thick- or double-lines.

 SVr4 curses implementations defined their line-drawing symbols in
 terms of intermediate symbols.
 This implementation extends those symbols, providing new definitions
 SVr4 curses implementations defined their line-drawing symbols in
 terms of intermediate symbols.
 This implementation extends those symbols, providing new definitions


@@ -423,12 +425,25 @@ may hold one non-spacing character.
 In the latter case,
 \fI\%ncurses\fP adds the non-spacing character to the active
 (base) spacing character.
 In the latter case,
 \fI\%ncurses\fP adds the non-spacing character to the active
 (base) spacing character.

+.SS TABSIZE
+The
+.B TABSIZE
+variable is implemented in SVr4 and other versions of
+.IR curses ,
+but is not specified by X/Open Curses
+(see \fBcurs_variables\fP(3X)).

 .SH SEE ALSO
 .SH SEE ALSO

+\fB\%curs_addch\fP(3X) describes comparable functions of the
+.I \%ncurses
+library in its non-wide-character configuration.
+.PP

 \fB\%curses\fP(3X),
 \fB\%curses\fP(3X),

-\fB\%curs_addch\fP(3X),
+\fB\%curs_addwstr\fP(3X),
+\fB\%curs_add_wchstr\fP(3X),

 \fB\%curs_attr\fP(3X),
 \fB\%curs_clear\fP(3X),
 \fB\%curs_getcchar\fP(3X),
 \fB\%curs_outopts\fP(3X),
 \fB\%curs_refresh\fP(3X),
 \fB\%curs_attr\fP(3X),
 \fB\%curs_clear\fP(3X),
 \fB\%curs_getcchar\fP(3X),
 \fB\%curs_outopts\fP(3X),
 \fB\%curs_refresh\fP(3X),

+\fB\%curs_variables\fP(3X),

 \fB\%putwc\fP(3)
 \fB\%putwc\fP(3)