+</PRE><H2><a name="h2-PORTABILITY">PORTABILITY</a></H2><PRE>
+ All these functions are described in the XSI Curses standard, Issue 4.
+ The defaults specified for forms-drawing characters apply in the POSIX
+ locale.
+
+
+</PRE><H3><a name="h3-ACS-Symbols">ACS Symbols</a></H3><PRE>
+ X/Open Curses states that the <I>ACS</I><B>_</B> definitions are <B>char</B> constants. For
+ the wide-character implementation (see <B>curs_add_wch</B>), there are
+ analogous <I>WACS</I><B>_</B> definitions which are <B>cchar_t</B> constants. Some
+ implementations are problematic:
+
+ <B>o</B> Some implementations define the ACS symbols to a constant (such as
+ Solaris), while others define those to entries in an array.
+
+ This implementation uses an array <B>acs_map</B>, as done in SVr4 curses.
+ NetBSD also uses an array, actually named <B>_acs_char</B>, with a <B>#define</B>
+ for compatibility.
+
+ <B>o</B> HPUX curses equates some of the <I>ACS</I><B>_</B> symbols to the analogous <I>WACS</I><B>_</B>
+ symbols as if the <I>ACS</I><B>_</B> symbols were wide characters. The
+ misdefined symbols are the arrows and other symbols which are not
+ used for line-drawing.
+
+ <B>o</B> X/Open Curses (issues 2 through 7) has a typographical error for
+ the ACS_LANTERN symbol, equating its "VT100+ Character" to <B>I</B>
+ (capital I), while the header files for SVr4 curses and the various
+ implementations use <B>i</B> (lowercase).
+
+ None of the terminal descriptions on Unix platforms use uppercase-
+ I, except for Solaris (i.e., <I>screen</I>'s terminal description,
+ apparently based on the X/Open documentation around 1995). On the
+ other hand, the terminal description <I>gs6300</I> (AT&T PC6300 with EMOTS
+ Terminal Emulator) uses lowercase-i.
+
+ Some ACS symbols (ACS_S3, ACS_S7, ACS_LEQUAL, ACS_GEQUAL, ACS_PI,
+ ACS_NEQUAL, ACS_STERLING) were not documented in any publicly released
+ System V. However, many publicly available terminfos include <B>acsc</B>
+ strings in which their key characters (pryz{|}) are embedded, and a
+ second-hand list of their character descriptions has come to light.
+ The ACS-prefixed names for them were invented for <B><A HREF="ncurses.3X.html">ncurses(3X)</A></B>.
+
+ The <I>displayed</I> values for the <I>ACS</I><B>_</B> and <I>WACS</I><B>_</B> constants depend on
+
+ <B>o</B> the library configuration, i.e., <B>ncurses</B> versus <B>ncursesw</B>, where the
+ latter is capable of displaying Unicode while the former is not,
+ and
+
+ <B>o</B> whether the <I>locale</I> uses UTF-8 encoding.
+
+ In certain cases, the terminal is unable to display line-drawing
+ characters except by using UTF-8 (see the discussion of
+ <B>NCURSES_NO_UTF8_ACS</B> in <B><A HREF="ncurses.3X.html">ncurses(3X)</A></B>).
+
+
+</PRE><H3><a name="h3-Character-Set">Character Set</a></H3><PRE>
+ X/Open Curses assumes that the parameter passed to <B>waddch</B> contains a
+ single character. As discussed in <B><A HREF="curs_attr.3X.html">curs_attr(3X)</A></B>, that character may
+ have been more than eight bits in an SVr3 or SVr4 implementation, but
+ in the X/Open Curses model, the details are not given. The important
+ distinction between SVr4 curses and X/Open Curses is that the non-
+ character information (attributes and color) was separated from the
+ character information which is packed in a <B>chtype</B> to pass to <B>waddch</B>.
+
+ In this implementation, <B>chtype</B> holds an eight-bit character. But
+ ncurses allows multibyte characters to be passed in a succession of
+ calls to <B>waddch</B>. The other implementations do not do this; a call to
+ <B>waddch</B> passes exactly one character which may be rendered as one or
+ more cells on the screen depending on whether it is printable.
+
+ Depending on the locale settings, ncurses will inspect the byte passed
+ in each call to <B>waddch</B>, and check if the latest call will continue a
+ multibyte sequence. When a character is <I>complete</I>, ncurses displays the
+ character and moves to the next position in the screen.
+
+ If the calling application interrupts the succession of bytes in a
+ multibyte character by moving the current location (e.g., using <B>wmove</B>),
+ ncurses discards the partially built character, starting over again.
+
+ For portability to other implementations, do not rely upon this
+ behavior:
+
+ <B>o</B> check if a character can be represented as a single byte in the
+ current locale before attempting call <B>waddch</B>, and
+
+ <B>o</B> call <B>wadd_wch</B> for characters which cannot be handled by <B>waddch</B>.
+
+
+</PRE><H3><a name="h3-TABSIZE">TABSIZE</a></H3><PRE>
+ The <B>TABSIZE</B> variable is implemented in SVr4 and other versions of
+ curses, but is not part of X/Open curses (see <B><A HREF="curs_variables.3X.html">curs_variables(3X)</A></B> for
+ more details).
+
+ If <I>ch</I> is a carriage return, the cursor is moved to the beginning of the
+ current row of the window. This is true of other implementations, but
+ is not documented.
+
+
+</PRE><H2><a name="h2-SEE-ALSO">SEE ALSO</a></H2><PRE>
+ <B><A HREF="curses.3X.html">curses(3X)</A></B>, <B><A HREF="curs_attr.3X.html">curs_attr(3X)</A></B>, <B><A HREF="curs_clear.3X.html">curs_clear(3X)</A></B>, <B><A HREF="curs_inch.3X.html">curs_inch(3X)</A></B>,
+ <B><A HREF="curs_outopts.3X.html">curs_outopts(3X)</A></B>, <B><A HREF="curs_refresh.3X.html">curs_refresh(3X)</A></B>, <B><A HREF="curs_variables.3X.html">curs_variables(3X)</A></B>, <B>putc(3)</B>.
+
+ Comparable functions in the wide-character (ncursesw) library are
+ described in <B><A HREF="curs_add_wch.3X.html">curs_add_wch(3X)</A></B>.