summaryrefslogtreecommitdiffstats
path: root/upstream/opensuse-tumbleweed/man3/add_wch.3ncurses
diff options
context:
space:
mode:
Diffstat (limited to 'upstream/opensuse-tumbleweed/man3/add_wch.3ncurses')
-rw-r--r--upstream/opensuse-tumbleweed/man3/add_wch.3ncurses33
1 files changed, 24 insertions, 9 deletions
diff --git a/upstream/opensuse-tumbleweed/man3/add_wch.3ncurses b/upstream/opensuse-tumbleweed/man3/add_wch.3ncurses
index 53b01b37..144f29ce 100644
--- a/upstream/opensuse-tumbleweed/man3/add_wch.3ncurses
+++ b/upstream/opensuse-tumbleweed/man3/add_wch.3ncurses
@@ -28,8 +28,8 @@
.\" authorization. *
.\"***************************************************************************
.\"
-.\" $Id: curs_add_wch.3x,v 1.53 2024/01/13 22:05:39 tom Exp $
-.TH add_wch 3NCURSES 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 add_wch 3NCURSES 2024-04-20 "ncurses 6.5" "Library calls"
.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
-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
@@ -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
-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,
@@ -323,7 +325,7 @@ Note that
\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
@@ -338,7 +340,7 @@ wide characters.
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
@@ -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.
+.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 \fB\%curses_variables\fP(3NCURSES)).
.SH SEE ALSO
+\fB\%addch\fP(3NCURSES) describes comparable functions of the
+.I \%ncurses
+library in its non-wide-character configuration.
+.PP
\fB\%ncurses\fP(3NCURSES),
-\fB\%addch\fP(3NCURSES),
+\fB\%addwstr\fP(3NCURSES),
+\fB\%add_wchstr\fP(3NCURSES),
\fB\%attr\fP(3NCURSES),
\fB\%clear\fP(3NCURSES),
\fB\%getcchar\fP(3NCURSES),
\fB\%outopts\fP(3NCURSES),
\fB\%refresh\fP(3NCURSES),
+\fB\%curses_variables\fP(3NCURSES),
\fB\%putwc\fP(3)