X-Git-Url: https://ncurses.scripts.mit.edu/?a=blobdiff_plain;f=doc%2Fhtml%2Fman%2Fcurs_addch.3x.html;h=4ffe0a7ff8c4b4d55c67ca7d320fbd15032991a8;hb=a919b0ee00a6287c7e29330be52f9bb557503288;hp=39887f41f9e2e72f1e7ae54637c884aa351ff674;hpb=027d0c57c4c4d6690e8d8727888d3282dbe9aa86;p=ncurses.git diff --git a/doc/html/man/curs_addch.3x.html b/doc/html/man/curs_addch.3x.html index 39887f41..4ffe0a7f 100644 --- a/doc/html/man/curs_addch.3x.html +++ b/doc/html/man/curs_addch.3x.html @@ -27,7 +27,7 @@ * sale, use or other dealings in this Software without prior written * * authorization. * **************************************************************************** - * @Id: curs_addch.3x,v 1.35 2015/05/13 19:18:37 tom Exp @ + * @Id: curs_addch.3x,v 1.37 2015/09/05 21:13:25 tom Exp @ --> @@ -67,6 +67,9 @@

DESCRIPTION

+
+
+

Adding characters

        The  addch,  waddch, mvaddch and mvwaddch routines put the
        character ch into the given window at its  current  window
        position,  which  is then advanced.  They are analogous to
@@ -115,6 +118,9 @@
        fined video attribute constants that can be usefully OR'ed
        into characters.
 
+
+
+

Echoing characters

        The  echochar  and  wechochar routines are equivalent to a
        call to addch followed by a call to refresh, or a call  to
        waddch followed by a call to wrefresh.  The knowledge that
@@ -130,8 +136,11 @@
        characters to the screen with routines of the  addch  fam-
        ily.   The  default  character listed below is used if the
        acsc  capability  does  not  define  a   terminal-specific
-       replacement for it.  The names are taken from VT100 nomen-
-       clature.
+       replacement for it, or if the terminal and locale configu-
+       ration requires Unicode but the library is unable  to  use
+       Unicode.
+
+       The names are taken from VT100 nomenclature.
 
        Name           Default   Description
        --------------------------------------------------
@@ -172,41 +181,54 @@
 

RETURN VALUE

        All routines return the integer ERR upon failure and OK on
-       success  (the  SVr4 manuals specify only "an integer value
+       success (the SVr4 manuals specify only "an  integer  value
        other than ERR") upon successful completion, unless other-
        wise noted in the preceding routine descriptions.
 
-       Functions  with a "mv" prefix first perform a cursor move-
-       ment using wmove, and return an error if the  position  is
+       Functions with a "mv" prefix first perform a cursor  move-
+       ment  using  wmove, and return an error if the position is
        outside the window, or if the window pointer is null.
 
 
 

NOTES

-       Note  that  addch,  mvaddch, mvwaddch, and echochar may be
+       Note that addch, mvaddch, mvwaddch, and  echochar  may  be
        macros.
 
 
 

PORTABILITY

-       All these functions are described in the XSI Curses  stan-
-       dard,  Issue  4.  The defaults specified for forms-drawing
+       All  these functions are described in the XSI Curses stan-
+       dard, Issue 4.  The defaults specified  for  forms-drawing
        characters apply in the POSIX locale.
 
-       X/Open Curses states that the ACS_  definitions  are  char
-       constants.   For  the  wide-character  implementation (see
+       X/Open  Curses  states  that the ACS_ definitions are char
+       constants.  For  the  wide-character  implementation  (see
        curs_add_wch), there are analogous WACS_ definitions which
        are cchar_t constants.
 
-       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 acsc 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
+       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  acsc 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
        ncurses(3x).
 
+       The  displayed  values  for  the  ACS_ and WACS_ constants
+       depend on
+
+       o   the library configuration, i.e., ncurses versus ncurs-
+           esw, where the latter is capable of displaying Unicode
+           while the former is not, and
+
+       o   whether the locale uses UTF-8 encoding.
+
+       In certain cases, the terminal is unable to display  line-
+       drawing  characters except by using UTF-8 (see the discus-
+       sion of NCURSES_NO_UTF8_ACS in ncurses(3x)).
+
        The TABSIZE variable is implemented in  some  versions  of
        curses, but is not part of X/Open curses.
 
@@ -234,6 +256,8 @@
 
  • SYNOPSIS
  • DESCRIPTION