X-Git-Url: http://ncurses.scripts.mit.edu/?p=ncurses.git;a=blobdiff_plain;f=man%2Fcurs_add_wch.3x;h=01fd9225e0217f5baf7b6a931fe71c2c60c17133;hp=70d849f1c3b662c6a0112cf9d15617aabc9b7888;hb=HEAD;hpb=bf2c36c4930ac5bb04cd2b1ba209cd09b6f510ab diff --git a/man/curs_add_wch.3x b/man/curs_add_wch.3x index 70d849f1..d1eb9a31 100644 --- a/man/curs_add_wch.3x +++ b/man/curs_add_wch.3x @@ -28,8 +28,8 @@ .\" 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 @@ -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 \fBcurs_variables\fP(3X)). .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\%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_variables\fP(3X), \fB\%putwc\fP(3)