captoinfo 1m 2023-09-09 ncurses 6.4 User commands

captoinfo 1m 2023-09-16 ncurses 6.4 User commands

captoinfo 1m 2023-09-09 ncurses 6.4 User commands

captoinfo 1m 2023-09-16 ncurses 6.4 User commands

 captoinfo(1m)                    User commands                   captoinfo(1m)
 
@@ -52,7 +52,9 @@

SYNOPSIS

-       captoinfo [-vn width]  [-V] [-1] [-w width] file ...
+       captoinfo [tic-option] file ...
+
+       captoinfo -V

DESCRIPTION

@@ -67,17 +69,9 @@
        is  extracted  from  that file.  If the environment variable TERMCAP is
        not set, then the file /usr/share/terminfo is read.
 
-       -v   print out tracing information on standard  error  as  the  program
-            runs.
-
-       -V   print  out the version of the program in use on standard error and
-            exit.
-
-       -1   cause the fields to print out  one  to  a  line.   Otherwise,  the
-            fields  will be printed several to a line to a maximum width of 60
-            characters.
-
-       -w   change the output to width characters.
+       This utility is implemented as a link to tic(1m), with the latter's  -I
+       option  implied.  You can use other tic options such as -1, -f, -v, -w,
+       and -x.

FILES

@@ -112,13 +106,13 @@
        PN       po     XENIX   prtr_off
        PS       pf     XENIX   prtr_on
        PU       kP     XENIX   key_ppage
-
        RT       @8     XENIX   kent
        UP       ku     XENIX   kcuu1
        KA       k;     Tek     key_f10
        KB       F1     Tek     key_f11
        KC       F2     Tek     key_f12
        KD       F3     Tek     key_f13
+
        KE       F4     Tek     key_f14
        KF       F5     Tek     key_f15
        BC       Sb     Tek     set_background
@@ -181,15 +175,12 @@

NOTES

-       This utility is actually a link to tic(1m), running in  -I  mode.   You
-       can use other tic options such as -f and  -x.
-
-       The  verbose option is not identical to SVr4's.  Under SVr4, instead of
+       The verbose option is not identical to SVr4's.  Under SVr4, instead  of
        following the -v with a trace level n, you repeat it n times.

PORTABILITY

-       X/Open Curses, Issue 7 (2009) describes tic  briefly,  but  omits  this
+       X/Open  Curses,  Issue  7  (2009) describes tic briefly, but omits this
        program.  SVr4 systems provide captoinfo as a separate application from
        tic.
 
@@ -199,7 +190,7 @@

AUTHOR

@@ -208,7 +199,7 @@
 
 
 
-ncurses 6.4                       2023-09-09                     captoinfo(1m)
+ncurses 6.4                       2023-09-16                     captoinfo(1m)

clear 1 2023-09-09 ncurses 6.4 User commands

clear 1 2023-09-16 ncurses 6.4 User commands

clear 1 2023-09-09 ncurses 6.4 User commands

clear 1 2023-09-16 ncurses 6.4 User commands

 clear(1)                         User commands                        clear(1)
 
@@ -150,11 +150,11 @@

curs_add_wch 3x 2023-08-19 ncurses 6.4 Library calls

curs_add_wch 3x 2023-09-16 ncurses 6.4 Library calls

 curs_add_wch(3x)                 Library calls                curs_add_wch(3x)
 
@@ -49,8 +49,7 @@

NAME

        add_wch, wadd_wch, mvadd_wch, mvwadd_wch, echo_wchar, wecho_wchar - add
-       a complex character and rendition to a curses window, then advance  the
-       cursor
+       a curses complex character to a window and advance the cursor

SYNOPSIS

@@ -68,53 +67,53 @@

DESCRIPTION

add_wch

-       The  add_wch,  wadd_wch,  mvadd_wch,  and  mvwadd_wch functions put the
-       complex character wch into the given window at  its  current  position,
-       which  is then advanced.  These functions perform wrapping and special-
+       The add_wch, wadd_wch, mvadd_wch,  and  mvwadd_wch  functions  put  the
+       complex  character  wch  into the given window at its current position,
+       which is then advanced.  These functions perform wrapping and  special-
        character processing as follows:
 
-       o   If wch refers to a spacing character, then any  previous  character
-           at  that  location is removed.  A new character specified by wch is
-           placed at that location  with  rendition  specified  by  wch.   The
-           cursor  then  advances after this spacing character, to prepare for
+       o   If  wch  refers to a spacing character, then any previous character
+           at that location is removed.  A new character specified by  wch  is
+           placed  at  that  location  with  rendition  specified by wch.  The
+           cursor then advances after this spacing character, to  prepare  for
            writing the next character on the screen.
 
            The newly added spacing character is the base of the active complex
-           character.   Subsequent non-spacing characters can be combined with
+           character.  Subsequent non-spacing characters can be combined  with
            this base until another spacing character is written to the screen,
            or the cursor is moved, e.g., using wmove.
 
-       o   If  wch  refers  to  a non-spacing character, it is appended to the
+       o   If wch refers to a non-spacing character, it  is  appended  to  the
            active complex character, retaining the previous characters at that
            location.  The rendition specified by wch is ignored.
 
-           The  cursor  is  not advanced after adding a non-spacing character.
+           The cursor is not advanced after adding  a  non-spacing  character.
            Subsequent calls to add non-spacing characters will update the same
            position.
 
-       o   If  the character part of wch is a tab, newline, backspace or other
+       o   If the character part of wch is a tab, newline, backspace or  other
            control character, the window is updated and the cursor moves as if
            addch were called.

echo_wchar

        The echo_wchar function is functionally equivalent to a call to add_wch
-       followed by a call  to  refresh(3x).   Similarly,  the  wecho_wchar  is
-       functionally  equivalent  to  a  call to wadd_wch followed by a call to
-       wrefresh.  The knowledge that only a single character is  being  output
-       is   taken  into  consideration  and,  for  non-control  characters,  a
-       considerable performance  gain  might  be  seen  by  using  the  *echo*
+       followed  by  a  call  to  refresh(3x).   Similarly, the wecho_wchar is
+       functionally equivalent to a call to wadd_wch followed  by  a  call  to
+       wrefresh.   The  knowledge that only a single character is being output
+       is  taken  into  consideration  and,  for  non-control  characters,   a
+       considerable  performance  gain  might  be  seen  by  using  the *echo*
        functions instead of their equivalents.

Line Graphics

-       Like  addch(3x), addch_wch accepts symbols which make it simple to draw
-       lines and other frequently  used  special  characters.   These  symbols
+       Like addch(3x), addch_wch accepts symbols which make it simple to  draw
+       lines  and  other  frequently  used  special characters.  These symbols
        correspond to the same VT100 line-drawing set as addch(3x).
 
        ACS               Unicode    ASCII     acsc    Glyph
-
        Name              Default    Default   char    Name
+
        ------------------------------------------------------------------------
        WACS_BLOCK        0x25ae     #         0       solid square block
        WACS_BOARD        0x2592     #         h       board of squares
@@ -149,7 +148,7 @@
        WACS_URCORNER     0x2510     +         k       upper right-hand corner
        WACS_VLINE        0x2502     |         x       vertical line
 
-       The  wide-character  configuration  of ncurses also defines symbols for
+       The wide-character configuration of ncurses also  defines  symbols  for
        thick lines (acsc "J" to "V"):
 
        ACS               Unicode   ASCII     acsc    Glyph
@@ -179,15 +178,15 @@
        WACS_D_LTEE       0x2560    +         F       double tee pointing right
        WACS_D_PLUS       0x256c    +         E       double large plus
        WACS_D_RTEE       0x2563    +         G       double tee pointing left
-
        WACS_D_TTEE       0x2566    +         I       double tee pointing down
+
        WACS_D_ULCORNER   0x2554    +         C       double upper left corner
        WACS_D_URCORNER   0x2557    +         B       double upper right corner
        WACS_D_VLINE      0x2551    |         Y       double vertical line
 
-       Unicode's descriptions  for  these  characters  differs  slightly  from
-       ncurses,  by  introducing  the  term "light" (along with less important
-       details).  Here are its descriptions for the normal, thick, and  double
+       Unicode's  descriptions  for  these  characters  differs  slightly from
+       ncurses, by introducing the term "light"  (along  with  less  important
+       details).   Here are its descriptions for the normal, thick, and double
        horizontal lines:
 
        o   U+2500 BOX DRAWINGS LIGHT HORIZONTAL
@@ -200,7 +199,7 @@

RETURN VALUE

        All routines return the integer ERR upon failure and OK on success.
 
-       X/Open  does  not  define  any  error  conditions.  This implementation
+       X/Open does not  define  any  error  conditions.   This  implementation
        returns an error
 
        o   if the window pointer is null or
@@ -209,15 +208,15 @@
 
        The latter may be due to different causes:
 
-       o   If scrollok(3x) is not enabled, writing a character  at  the  lower
+       o   If  scrollok(3x)  is  not enabled, writing a character at the lower
            right margin succeeds.  However, an error is returned because it is
            not possible to wrap to a new line
 
-       o   If an error is detected when converting a multibyte character to  a
-           sequence  of  bytes,  or  if  it  is not possible to add all of the
+       o   If  an error is detected when converting a multibyte character to a
+           sequence of bytes, or if it is not  possible  to  add  all  of  the
            resulting bytes in the window, an error is returned.
 
-       Functions with a "mv" prefix first  perform  a  cursor  movement  using
+       Functions  with  a  "mv"  prefix  first perform a cursor movement using
        wmove, and return an error if the position is outside the window, or if
        the window pointer is null.
 
@@ -227,80 +226,80 @@

PORTABILITY

-       All of these functions are described in the XSI Curses standard,  Issue
-       4.   The  defaults  specified  for line-drawing characters apply in the
+       All  of these functions are described in the XSI Curses standard, Issue
+       4.  The defaults specified for line-drawing  characters  apply  in  the
        POSIX locale.

WACS Symbols

-       X/Open Curses makes it clear that the WACS_ symbols should  be  defined
+       X/Open  Curses  makes it clear that the WACS_ symbols should be defined
        as a pointer to cchar_t data, e.g., in the discussion of border_set.  A
        few implementations are problematic:
 
        o   NetBSD curses defines the symbols as a wchar_t within a cchar_t.
 
        o   HPUX curses equates some of the ACS_ symbols to the analogous WACS_
-           symbols   as  if  the  ACS_  symbols  were  wide  characters.   The
-           misdefined symbols are the arrows and other symbols which  are  not
+           symbols  as  if  the  ACS_  symbols  were  wide  characters.    The
+           misdefined  symbols  are the arrows and other symbols which are not
            used for line-drawing.
 
        X/Open Curses does not define symbols for thick- or double-lines.  SVr4
-       curses implementations defined their line-drawing symbols in  terms  of
+       curses  implementations  defined their line-drawing symbols in terms of
        intermediate  symbols.   This  implementation  extends  those  symbols,
        providing new definitions which are not in the SVr4 implementations.
 
-       Not all  Unicode-capable  terminals  provide  support  for  VT100-style
-       alternate  character  sets  (i.e.,  the  acsc  capability),  with their
-       corresponding line-drawing characters.  X/Open Curses did  not  address
-       the   aspect  of  integrating  Unicode  with  line-drawing  characters.
-       Existing implementations of Unix curses (AIX, HPUX, Solaris)  use  only
+       Not  all  Unicode-capable  terminals  provide  support  for VT100-style
+       alternate character  sets  (i.e.,  the  acsc  capability),  with  their
+       corresponding  line-drawing  characters.  X/Open Curses did not address
+       the  aspect  of  integrating  Unicode  with  line-drawing   characters.
+       Existing  implementations  of Unix curses (AIX, HPUX, Solaris) use only
        the acsc character-mapping to provide this feature.  As a result, those
        implementations  can  only  use  single-byte  line-drawing  characters.
-       Ncurses  5.3  (2002)  provided a table of Unicode values to solve these
+       Ncurses 5.3 (2002) provided a table of Unicode values  to  solve  these
        problems.  NetBSD curses incorporated that table in 2010.
 
-       In this implementation, the Unicode values  are  used  instead  of  the
+       In  this  implementation,  the  Unicode  values are used instead of the
        terminal description's acsc mapping as discussed in ncurses(3x) for the
-       environment variable NCURSES_NO_UTF8_ACS.  In contrast,  for  the  same
+       environment  variable  NCURSES_NO_UTF8_ACS.   In contrast, for the same
        cases, the line-drawing characters described in curs_addch(3x) will use
        only the ASCII default values.
 
-       Having Unicode available does not solve all of the problems with  line-
+       Having  Unicode available does not solve all of the problems with line-
        drawing for curses:
 
-       o   The  closest  Unicode  equivalents to the VT100 graphics S1, S3, S7
-           and S9 frequently are not displayed at the regular intervals  which
+       o   The closest Unicode equivalents to the VT100 graphics  S1,  S3,  S7
+           and  S9 frequently are not displayed at the regular intervals which
            the terminal used.
 
-       o   The  lantern  is  a special case.  It originated with the AT&T 4410
-           terminal in the early 1980s.  There is no accessible  documentation
+       o   The lantern is a special case.  It originated with  the  AT&T  4410
+           terminal  in the early 1980s.  There is no accessible documentation
            depicting the lantern symbol on the AT&T terminal.
 
            Lacking documentation, most readers assume that a storm lantern was
            intended.  But there are several possibilities, all with problems.
 
-           Unicode 6.0 (2010) does provide two lantern  symbols:  U+1F383  and
-           U+1F3EE.   Those  were  not  available  in 2002, and are irrelevant
-           since they lie outside the BMP and as a result  are  not  generally
+           Unicode  6.0  (2010)  does provide two lantern symbols: U+1F383 and
+           U+1F3EE.  Those were not available  in  2002,  and  are  irrelevant
+           since  they  lie  outside the BMP and as a result are not generally
            available in terminals.  They are not storm lanterns, in any case.
 
            Most storm lanterns have a tapering glass chimney (to guard against
            tipping); some have a wire grid protecting the chimney.
 
-           For the tapering appearance,  U+2603 was adequate.   In  use  on  a
+           For  the  tapering  appearance,   U+2603 was adequate.  In use on a
            terminal, no one can tell what the image represents.  Unicode calls
            it a snowman.
 
            Others have suggested these alternatives: <section> U+00A7 (section
-           mark),  <Theta>  U+0398 (theta), <Phi> U+03A6 (phi), <delta> U+03B4
+           mark), <Theta> U+0398 (theta), <Phi> U+03A6 (phi),  <delta>  U+03B4
            (delta),  U+2327 (x in a rectangle),  U+256C (forms double vertical
            and horizontal), and  U+2612 (ballot box with x).

Complex Characters

-       The  complex  character  type  cchar_t  can  store  more  than one wide
-       character (wchar_t).  The X/Open Curses description  does  not  mention
-       this  possibility,  describing  only  the  cases where wch is a spacing
+       The complex character  type  cchar_t  can  store  more  than  one  wide
+       character  (wchar_t).   The  X/Open Curses description does not mention
+       this possibility, describing only the cases  where  wch  is  a  spacing
        character or a non-spacing character.
 
        This implementation assumes that wch is constructed using setcchar(3x),
@@ -311,7 +310,7 @@
 
        o   may hold one non-spacing character.
 
-       In the latter case, ncurses  adds  the  non-spacing  character  to  the
+       In  the  latter  case,  ncurses  adds  the non-spacing character to the
        active (base) spacing character.
 
 
@@ -321,7 +320,7 @@
 
 
 
-ncurses 6.4                       2023-08-19                  curs_add_wch(3x)
+ncurses 6.4                       2023-09-16                  curs_add_wch(3x)

curs_add_wchstr 3x 2022-02-12 ncurses 6.4 Library calls

curs_add_wchstr 3x 2023-09-16 ncurses 6.4 Library calls

curs_add_wchstr 3x 2022-02-12 ncurses 6.4 Library calls

curs_add_wchstr 3x 2023-09-16 ncurses 6.4 Library calls

 curs_add_wchstr(3x)              Library calls             curs_add_wchstr(3x)
 
@@ -47,9 +47,9 @@

NAME

-       add_wchstr, add_wchnstr, wadd_wchstr, wadd_wchnstr, mvadd_wchstr,
-       mvadd_wchnstr, mvwadd_wchstr, mvwadd_wchnstr - add an array of complex
-       characters (and attributes) to a curses window
+       add_wchstr,   add_wchnstr,   wadd_wchstr,  wadd_wchnstr,  mvadd_wchstr,
+       mvadd_wchnstr, mvwadd_wchstr, mvwadd_wchnstr -  add  a  curses  complex
+       character string to a window

SYNOPSIS

@@ -96,8 +96,8 @@

RETURN VALUE

        All functions return the integer ERR upon failure and OK on success.
 
-       X/Open does not define any error conditions.  This  implementation  re-
-       turns an error if the window pointer is null.
+       X/Open does not  define  any  error  conditions.   This  implementation
+       returns an error if the window pointer is null.
 
        Functions  with  a  "mv"  prefix  first perform a cursor movement using
        wmove, and return an error if the position is outside the window, or if
@@ -115,12 +115,12 @@

curs_addch 3x 2023-08-19 ncurses 6.4 Library calls

curs_addch 3x 2023-09-16 ncurses 6.4 Library calls

 curs_addch(3x)                   Library calls                  curs_addch(3x)
 
@@ -48,8 +48,8 @@

NAME

-       addch, waddch, mvaddch, mvwaddch, echochar, wechochar - add a character
-       (with attributes) to a curses window, then advance the cursor
+       addch,  waddch,  mvaddch,  mvwaddch, echochar, wechochar - add a curses
+       character to a window and advance the cursor

SYNOPSIS

@@ -308,7 +308,7 @@
 
 
 
-ncurses 6.4                       2023-08-19                    curs_addch(3x)
+ncurses 6.4                       2023-09-16                    curs_addch(3x)

curs_addchstr 3x 2022-02-12 ncurses 6.4 Library calls

curs_addchstr 3x 2023-09-16 ncurses 6.4 Library calls

curs_addchstr 3x 2022-02-12 ncurses 6.4 Library calls

curs_addchstr 3x 2023-09-16 ncurses 6.4 Library calls

 curs_addchstr(3x)                Library calls               curs_addchstr(3x)
 
@@ -47,9 +47,8 @@

NAME

-       addchstr, addchnstr, waddchstr, waddchnstr, mvaddchstr, mvaddchnstr,
-       mvwaddchstr, mvwaddchnstr - add a string of characters (and attributes)
-       to a curses window
+       addchstr,  addchnstr,  waddchstr,  waddchnstr, mvaddchstr, mvaddchnstr,
+       mvwaddchstr, mvwaddchnstr - add a curses character string to a window

SYNOPSIS

@@ -67,33 +66,33 @@

DESCRIPTION

-       These  functions copy the (null-terminated) chstr array into the window
-       image structure starting at the  current  cursor  position.   The  four
-       functions  with  n as the last argument copy at most n elements, but no
-       more than will fit on the line.   If  n=-1  then  the  whole  array  is
+       These functions copy the (null-terminated) chstr array into the  window
+       image  structure  starting  at  the  current cursor position.  The four
+       functions with n as the last argument copy at most n elements,  but  no
+       more  than  will  fit  on  the  line.   If n=-1 then the whole array is
        copied, to the maximum number of characters that will fit on the line.
 
-       The  window  cursor  is not advanced.  These functions work faster than
+       The window cursor is not advanced.  These functions  work  faster  than
        waddnstr.  On the other hand:
 
-       o   they do not perform checking (such as for the  newline,  backspace,
+       o   they  do  not perform checking (such as for the newline, backspace,
            or carriage return characters),
 
        o   they do not advance the current cursor position,
 
        o   they do not expand other control characters to ^-escapes, and
 
-       o   they  truncate  the  string  if it crosses the right margin, rather
+       o   they truncate the string if it crosses  the  right  margin,  rather
            than wrapping it around to the new line.

RETURN VALUE

        All functions return the integer ERR upon failure and OK on success.
 
-       X/Open does not define any error conditions.  This  implementation  re-
-       turns an error if the window pointer is null.
+       X/Open  does  not  define  any  error  conditions.  This implementation
+       returns an error if the window pointer is null.
 
-       Functions  with  a  "mv"  prefix  first perform a cursor movement using
+       Functions with a "mv" prefix first  perform  a  cursor  movement  using
        wmove, and return an error if the position is outside the window, or if
        the window pointer is null.
 
@@ -109,12 +108,12 @@

curs_addstr 3x 2023-03-11 ncurses 6.4 Library calls

curs_addstr 3x 2023-09-16 ncurses 6.4 Library calls

 curs_addstr(3x)                  Library calls                 curs_addstr(3x)
 
@@ -47,9 +47,8 @@

NAME

-       addstr, addnstr, waddstr, waddnstr, mvaddstr, mvaddnstr, mvwaddstr,
-       mvwaddnstr - add a string of characters to a curses window and advance
-       cursor
+       addstr,  addnstr,  waddstr,  waddnstr,  mvaddstr, mvaddnstr, mvwaddstr,
+       mvwaddnstr - add a string to a curses window and advance the cursor

SYNOPSIS

@@ -68,23 +67,23 @@

DESCRIPTION

        These functions write the (null-terminated) character string str on the
-       given window.  It is similar to calling waddch once for  each  byte  in
+       given  window.   It  is similar to calling waddch once for each byte in
        the string.
 
-       The mv functions perform cursor movement once, before writing any char-
-       acters.  Thereafter, the cursor is advanced as a side-effect of writing
-       to the window.
+       The mv functions perform  cursor  movement  once,  before  writing  any
+       characters.   Thereafter,  the  cursor  is advanced as a side-effect of
+       writing to the window.
 
-       The  four  functions with n as the last argument write at most n bytes,
-       or until a terminating null is reached.  If n is -1,  then  the  entire
+       The four functions with n as the last argument write at most  n  bytes,
+       or  until  a  terminating null is reached.  If n is -1, then the entire
        string will be added.

RETURN VALUE

        All functions return the integer ERR upon failure and OK on success.
 
-       X/Open  does  not define any error conditions.  This implementation re-
-       turns an error
+       X/Open does not  define  any  error  conditions.   This  implementation
+       returns an error
 
        o   if the window pointer is null or
 
@@ -92,16 +91,16 @@
 
        o   if the corresponding calls to waddch return an error.
 
-       Functions with a "mv" prefix first  perform  a  cursor  movement  using
+       Functions  with  a  "mv"  prefix  first perform a cursor movement using
        wmove, and return an error if the position is outside the window, or if
-       the window pointer is null.  If an error is returned by the  wmove,  no
+       the  window  pointer is null.  If an error is returned by the wmove, no
        characters are added to the window.
 
-       If  an  error  is  returned  by waddch (e.g., because the window is not
-       large enough, or an illegal byte sequence was detected)  only  part  of
-       the  string  may be added.  Aside from that, there is a special case in
-       waddch where an error may be  returned  after  successfully  writing  a
-       character  to  the  lower-right corner of a window when scrollok(3x) is
+       If an error is returned by waddch (e.g.,  because  the  window  is  not
+       large  enough,  or  an illegal byte sequence was detected) only part of
+       the string may be added.  Aside from that, there is a special  case  in
+       waddch  where  an  error  may  be returned after successfully writing a
+       character to the lower-right corner of a window  when  scrollok(3x)  is
        disabled.
 
 
@@ -118,7 +117,7 @@
 
 
 
-ncurses 6.4                       2023-03-11                   curs_addstr(3x)
+ncurses 6.4                       2023-09-16                   curs_addstr(3x)

curs_addwstr 3x 2023-07-15 ncurses 6.4 Library calls

curs_addwstr 3x 2023-09-16 ncurses 6.4 Library calls

curs_addwstr 3x 2023-07-15 ncurses 6.4 Library calls

curs_addwstr 3x 2023-09-16 ncurses 6.4 Library calls

 curs_addwstr(3x)                 Library calls                curs_addwstr(3x)
 
@@ -47,9 +47,9 @@

NAME

-       addwstr, addnwstr, waddwstr, waddnwstr, mvaddwstr, mvaddnwstr,
-       mvwaddwstr, mvwaddnwstr - add a string of wide characters to a curses
-       window and advance cursor
+       addwstr,   addnwstr,   waddwstr,   waddnwstr,   mvaddwstr,  mvaddnwstr,
+       mvwaddwstr, mvwaddnwstr - add  a  wide-character  string  to  a  curses
+       window and advance the cursor

SYNOPSIS

@@ -68,18 +68,18 @@

DESCRIPTION

        These  functions  write the characters of the (null-terminated) wchar_t
-       character string wstr on the given window.  It is similar to construct-
-       ing a cchar_t for each wchar_t in the string, then calling wadd_wch(3x)
-       for the resulting cchar_t:
+       character  string  wstr  on  the  given  window.   It  is  similar   to
+       constructing  a  cchar_t  for  each wchar_t in the string, then calling
+       wadd_wch(3x) for the resulting cchar_t:
 
        o   spacing and non-spacing characters in the string are processed  one
            at a time, and
 
        o   control characters are processed as in waddch(3x).
 
-       The mv functions perform cursor movement once, before writing any char-
-       acters.  Thereafter, the cursor is advanced as a side-effect of writing
-       to the window.
+       The  mv  functions  perform  cursor  movement  once, before writing any
+       characters.  Thereafter, the cursor is advanced  as  a  side-effect  of
+       writing to the window.
 
        The  four functions with n as the last argument write at most n wchar_t
        characters, or until a terminating null is reached.  If n is  -1,  then
@@ -89,8 +89,8 @@

RETURN VALUE

        All functions return the integer ERR upon failure and OK on success.
 
-       X/Open  does  not define any error conditions.  This implementation re-
-       turns an error
+       X/Open  does  not  define  any  error  conditions.  This implementation
+       returns an error
 
        o   if the window pointer is null or
 
@@ -116,7 +116,7 @@
 
 
 
-ncurses 6.4                       2023-07-15                  curs_addwstr(3x)
+ncurses 6.4                       2023-09-16                  curs_addwstr(3x)

curs_attr 3x 2023-09-09 ncurses 6.4 Library calls

curs_attr 3x 2023-09-16 ncurses 6.4 Library calls

curs_attr 3x 2023-09-09 ncurses 6.4 Library calls

curs_attr 3x 2023-09-16 ncurses 6.4 Library calls

 curs_attr(3x)                    Library calls                   curs_attr(3x)
 
@@ -71,9 +65,9 @@

NAME

        attr_get, wattr_get, attr_set, wattr_set, attr_off, wattr_off, attr_on,
        wattr_on, attroff, wattroff, attron, wattron, attrset, wattrset, chgat,
-       wchgat, mvchgat, mvwchgat, color_set, wcolor_set, standend, wstandend,
-       standout, wstandout - curses character and window attribute control
-       routines
+       wchgat,  mvchgat, mvwchgat, color_set, wcolor_set, standend, wstandend,
+       standout, wstandout -  manipulate  attributes  of  character  cells  in
+       curses windows

SYNOPSIS

@@ -117,14 +111,14 @@
        These  routines  manipulate the current attributes of the named window,
        which then apply to all characters that are  written  into  the  window
        with  waddch,  waddstr  and  wprintw.  Attributes are a property of the
-       character, and move with the character through any  scrolling  and  in-
-       sert/delete  line/character  operations.   To the extent possible, they
+       character, and move  with  the  character  through  any  scrolling  and
+       insert/delete  line/character operations.  To the extent possible, they
        are displayed as appropriate modifications to the graphic rendition  of
        characters put on the screen.
 
        These  routines do not affect the attributes used when erasing portions
-       of the window.  See curs_bkgd(3x) for functions which  modify  the  at-
-       tributes used for erasing and clearing.
+       of the window.   See  curs_bkgd(3x)  for  functions  which  modify  the
+       attributes used for erasing and clearing.
 
        Routines  which  do  not have a WINDOW* parameter apply to stdscr.  For
        example, attr_set is the stdscr variant of wattr_set.
@@ -133,8 +127,8 @@

Window attributes

        There are two sets of functions:
 
-       o   functions for manipulating the window attributes  and  color:  wat-
-           tr_set and wattr_get.
+       o   functions  for  manipulating  the  window  attributes  and   color:
+           wattr_set and wattr_get.
 
        o   functions  for manipulating only the window attributes (not color):
            wattr_on and wattr_off.
@@ -145,8 +139,8 @@
        Use wattr_get to retrieve attributes for the given window.
 
        Use  attr_on  and  wattr_on  to turn on window attributes, i.e., values
-       OR'd together in attr, without affecting  other  attributes.   Use  at-
-       tr_off  and  wattr_off to turn off window attributes, again values OR'd
+       OR'd  together  in  attr,  without  affecting  other  attributes.   Use
+       attr_off and wattr_off to turn off window attributes, again values OR'd
        together in attr, without affecting other attributes.
 
 
@@ -157,11 +151,11 @@
        because X/Open simply added an underscore (_) for the newer names.
 
        The int datatype used in the legacy routines is treated as if it is the
-       same size as chtype (used by addch(3x)).  It holds the common video at-
-       tributes  (such  as  bold,  reverse),  as well as a few bits for color.
-       Those bits correspond to the A_COLOR symbol.  The COLOR_PAIR macro pro-
-       vides  a value which can be OR'd into the attribute parameter.  For ex-
-       ample, as long as that value fits into the  A_COLOR  mask,  then  these
+       same size as chtype (used by addch(3x)).  It  holds  the  common  video
+       attributes  (such  as  bold, reverse), as well as a few bits for color.
+       Those bits correspond to the  A_COLOR  symbol.   The  COLOR_PAIR  macro
+       provides  a  value which can be OR'd into the attribute parameter.  For
+       example, as long as that value fits into the A_COLOR mask,  then  these
        calls produce similar results:
 
            attrset(A_BOLD | COLOR_PAIR(pair));
@@ -180,8 +174,8 @@
            int output = PAIR_NUMBER(value);
 
        The attrset routine is a legacy feature predating SVr4 curses but  kept
-       in X/Open Curses for the same reason that SVr4 curses kept it: compati-
-       bility.
+       in  X/Open  Curses  for  the  same  reason  that  SVr4  curses kept it:
+       compatibility.
 
        The remaining attr* functions operate exactly  like  the  corresponding
        attr_*  functions,  except  that they take arguments of type int rather
@@ -192,13 +186,13 @@

Change character rendition

-       The  routine  chgat changes the attributes of a given number of charac-
-       ters starting at the current cursor location of stdscr.   It  does  not
-       update  the cursor and does not perform wrapping.  A character count of
-       -1 or greater than the remaining  window  width  means  to  change  at-
-       tributes  all the way to the end of the current line.  The wchgat func-
-       tion generalizes this to any window; the mvwchgat function does a  cur-
-       sor move before acting.
+       The  routine  chgat  changes  the  attributes  of  a  given  number  of
+       characters starting at the current cursor location of stdscr.  It  does
+       not update the cursor and does not perform wrapping.  A character count
+       of -1 or greater than  the  remaining  window  width  means  to  change
+       attributes  all  the  way  to  the end of the current line.  The wchgat
+       function generalizes this to any window; the mvwchgat function  does  a
+       cursor move before acting.
 
        In  these  functions, the color pair argument is a color-pair index (as
        in the first argument of init_pair, see curs_color(3x)).
@@ -206,8 +200,8 @@

Change window color

        The routine color_set sets the current color of the given window to the
-       foreground/background  combination  described by the color pair parame-
-       ter.
+       foreground/background   combination   described   by   the  color  pair
+       parameter.

Standout

@@ -219,8 +213,8 @@
 
        o   they have well established legacy use, and
 
-       o   there is no ambiguity about the way the attributes  might  be  com-
-           bined with a color pair.
+       o   there is no  ambiguity  about  the  way  the  attributes  might  be
+           combined with a color pair.

VIDEO ATTRIBUTES

@@ -277,9 +271,9 @@

HISTORY

        X/Open Curses is largely based  on  SVr4  curses,  adding  support  for
-       "wide-characters"  (not  specific to Unicode).  Some of the X/Open dif-
-       ferences from SVr4 curses address the way video attributes can  be  ap-
-       plied  to  wide-characters.   But aside from that, attrset and attr_set
+       "wide-characters"  (not  specific  to  Unicode).   Some  of  the X/Open
+       differences from SVr4 curses address the way video  attributes  can  be
+       applied  to wide-characters.  But aside from that, attrset and attr_set
        are similar.  SVr4 curses provided the basic features for  manipulating
        video  attributes.  However, earlier versions of curses provided a part
        of these features.
@@ -290,11 +284,11 @@
        standout  and  standend which were carried along into X/Open Curses due
        to their pervasive use in legacy applications.
 
-       Some terminals in the 1980s  could  support  a  variety  of  video  at-
-       tributes,  although the BSD curses library could do nothing with those.
-       System V (1983) provided an improved curses library.  It defined the A_
-       symbols  for  use  by  applications to manipulate the other attributes.
-       There are few useful references for the chronology.
+       Some  terminals  in  the  1980s  could  support  a  variety  of   video
+       attributes,  although  the  BSD  curses  library  could do nothing with
+       those.  System V  (1983)  provided  an  improved  curses  library.   It
+       defined  the A_ symbols for use by applications to manipulate the other
+       attributes.  There are few useful references for the chronology.
 
        Goodheart's book UNIX Curses Explained (1991)  describes  SVr3  (1987),
        commenting on several functions:
@@ -322,9 +316,9 @@
        This  table  showing  the number of bits for A_COLOR and A_CHARTEXT was
        gleaned from the curses header files for various operating systems  and
        architectures.   The inferred architecture and notes reflect the format
-       and size of the defined constants as well as clues such as  the  alter-
-       nate  character  set implementation.  A 32-bit library can be used on a
-       64-bit system, but not necessarily the reverse.
+       and size of the  defined  constants  as  well  as  clues  such  as  the
+       alternate  character  set implementation.  A 32-bit library can be used
+       on a 64-bit system, but not necessarily the reverse.
 
               Year   System        Arch    Color   Char   Notes
               ----------------------------------------------------------------
@@ -353,11 +347,11 @@
 
           Regarding OSF/1 (and Tru64),
 
-          o   These used 64-bit hardware.  Like ncurses, the OSF/1 curses  in-
-              terface is not customized for 32-bit and 64-bit versions.
+          o   These used 64-bit hardware.   Like  ncurses,  the  OSF/1  curses
+              interface is not customized for 32-bit and 64-bit versions.
 
-          o   Unlike other systems which evolved from AT&T code, OSF/1 provid-
-              ed a new implementation for X/Open curses.
+          o   Unlike  other  systems  which  evolved  from  AT&T  code,  OSF/1
+              provided a new implementation for X/Open curses.
 
           Regarding Solaris,
 
@@ -367,8 +361,8 @@
               Sun's copyright began in 1996.
 
           o   Sun updated the X/Open curses interface after 64-bit support was
-              introduced in 1997, but did not modify the  SVr4  curses  inter-
-              face.
+              introduced  in  1997,  but  did  not  modify  the  SVr4   curses
+              interface.
 
           Regarding U/Win,
 
@@ -398,17 +392,17 @@

EXTENSIONS

        This implementation provides the A_ITALIC attribute for terminals which
-       have  the  enter_italics_mode (sitm) and exit_italics_mode (ritm) capa-
-       bilities.  Italics are not mentioned in X/Open Curses.  Unlike the oth-
-       er  video attributes, A_ITALIC is unrelated to the set_attributes capa-
-       bilities.  This implementation makes the  assumption  that  exit_attri-
-       bute_mode may also reset italics.
+       have   the   enter_italics_mode  (sitm)  and  exit_italics_mode  (ritm)
+       capabilities.  Italics are not mentioned in X/Open Curses.  Unlike  the
+       other  video  attributes,  A_ITALIC  is unrelated to the set_attributes
+       capabilities.   This   implementation   makes   the   assumption   that
+       exit_attribute_mode may also reset italics.
 
        Each  of  the functions added by XSI Curses has a parameter opts, which
-       X/Open Curses still (after more than twenty  years)  documents  as  re-
-       served for future use, saying that it should be NULL.  This implementa-
-       tion uses that parameter in ABI 6 for the functions which have a color-
-       pair parameter to support extended color pairs:
+       X/Open Curses  still  (after  more  than  twenty  years)  documents  as
+       reserved  for  future  use,  saying  that  it  should  be  NULL.   This
+       implementation uses that parameter in ABI 6  for  the  functions  which
+       have a color-pair parameter to support extended color pairs:
 
        o   For functions which modify the color, e.g., wattr_set and wattr_on,
            if opts is set it is treated as a pointer to int, and used  to  set
@@ -436,14 +430,14 @@
        The XSI Curses standard states that whether the  traditional  functions
        attron/attroff/attrset  can  manipulate  attributes other than A_BLINK,
        A_BOLD, A_DIM, A_REVERSE, A_STANDOUT, or A_UNDERLINE is  "unspecified".
-       Under  this implementation as well as SVr4 curses, these functions cor-
-       rectly manipulate all  other  highlights  (specifically,  A_ALTCHARSET,
+       Under  this  implementation  as  well  as  SVr4 curses, these functions
+       correctly manipulate all other highlights (specifically,  A_ALTCHARSET,
        A_PROTECT, and A_INVIS).
 
        XSI Curses added these entry points:
 
-              attr_get, attr_on, attr_off, attr_set, wattr_on, wattr_off, wat-
-              tr_get, wattr_set
+              attr_get,  attr_on,  attr_off,  attr_set,  wattr_on,  wattr_off,
+              wattr_get, wattr_set
 
        The new functions are intended to work with a new series  of  highlight
        macros prefixed with WA_.  The older macros have direct counterparts in
@@ -467,12 +461,12 @@
            A_ and WA_-using functions operates on the  same  current-highlight
            information.
 
-       o   However, in some implementations, those symbols have unrelated val-
-           ues.
+       o   However,  in  some  implementations,  those  symbols have unrelated
+           values.
 
            For example, the Solaris xpg4 (X/Open) curses declares attr_t to be
-           an unsigned short integer (16-bits), while chtype is a unsigned in-
-           teger (32-bits).  The WA_ symbols in this case are  different  from
+           an  unsigned  short  integer  (16-bits), while chtype is a unsigned
+           integer (32-bits).  The WA_ symbols in this case are different from
            the  A_  symbols because they are used for a smaller datatype which
            does not represent A_CHARTEXT or A_COLOR.
 
@@ -482,16 +476,16 @@
 
        o   Because ncurses's attr_t can hold a  color  pair  (in  the  A_COLOR
            field),  a  call to wattr_on, wattr_off, or wattr_set may alter the
-           window's color.  If the color pair information in the attribute pa-
-           rameter is zero, no change is made to the window's color.
+           window's color.  If the color pair  information  in  the  attribute
+           parameter is zero, no change is made to the window's color.
 
            This is consistent with SVr4 curses; X/Open Curses does not specify
            this.
 
-       The XSI standard extended conformance level adds new highlights A_HORI-
-       ZONTAL,  A_LEFT,  A_LOW,  A_RIGHT, A_TOP, A_VERTICAL (and corresponding
-       WA_ macros for each).  As of August 2013, no  known  terminal  provides
-       these highlights (i.e., via the sgr1 capability).
+       The  XSI  standard  extended  conformance  level  adds  new  highlights
+       A_HORIZONTAL,   A_LEFT,   A_LOW,   A_RIGHT,   A_TOP,   A_VERTICAL  (and
+       corresponding WA_ macros for  each).   As  of  August  2013,  no  known
+       terminal provides these highlights (i.e., via the sgr1 capability).

RETURN VALUE

@@ -503,8 +497,8 @@
 
        o   returns an error if the window pointer is null.
 
-       o   returns an error if the color pair parameter for wcolor_set is out-
-           side the range 0..COLOR_PAIRS-1.
+       o   returns  an  error  if  the  color pair parameter for wcolor_set is
+           outside the range 0..COLOR_PAIRS-1.
 
        o   does not return an error if either of the parameters  of  wattr_get
            used for retrieving attribute or color-pair values is NULL.
@@ -520,7 +514,7 @@
 
 
 
-ncurses 6.4                       2023-09-09                     curs_attr(3x)
+ncurses 6.4                       2023-09-16                     curs_attr(3x)

curs_beep 3x 2021-12-25 ncurses 6.4 Library calls

curs_beep 3x 2023-09-16 ncurses 6.4 Library calls

curs_beep 3x 2021-12-25 ncurses 6.4 Library calls

curs_beep 3x 2023-09-16 ncurses 6.4 Library calls

 curs_beep(3x)                    Library calls                   curs_beep(3x)
 
@@ -47,7 +47,7 @@

NAME

-       beep, flash - curses bell and screen flash routines
+       beep, flash - ring the (visual) bell of the terminal with curses

SYNOPSIS

@@ -86,7 +86,7 @@
 
 
 
-ncurses 6.4                       2021-12-25                     curs_beep(3x)
+ncurses 6.4                       2023-09-16                     curs_beep(3x)

curs_bkgd 3x 2023-07-01 ncurses 6.4 Library calls

curs_bkgd 3x 2023-09-16 ncurses 6.4 Library calls

curs_bkgd 3x 2023-07-01 ncurses 6.4 Library calls

curs_bkgd 3x 2023-09-16 ncurses 6.4 Library calls

 curs_bkgd(3x)                    Library calls                   curs_bkgd(3x)
 
@@ -47,8 +47,8 @@

NAME

-       bkgdset,  wbkgdset,  bkgd,  wbkgd,  getbkgd  - curses window background
-       manipulation routines
+       bkgdset,  wbkgdset,  bkgd,  wbkgd, getbkgd - manipulate background of a
+       curses window of characters

SYNOPSIS

@@ -179,7 +179,7 @@
 
 
 
-ncurses 6.4                       2023-07-01                     curs_bkgd(3x)
+ncurses 6.4                       2023-09-16                     curs_bkgd(3x)

curs_bkgrnd 3x 2023-08-12 ncurses 6.4 Library calls

curs_bkgrnd 3x 2023-09-16 ncurses 6.4 Library calls

curs_bkgrnd 3x 2023-08-12 ncurses 6.4 Library calls

curs_bkgrnd 3x 2023-09-16 ncurses 6.4 Library calls

 curs_bkgrnd(3x)                  Library calls                 curs_bkgrnd(3x)
 
@@ -47,15 +47,15 @@

NAME

-       bkgrnd,  wbkgrnd, bkgrndset, wbkgrndset, getbkgrnd, wgetbkgrnd - curses
-       window complex background manipulation routines
+       bkgrnd,   wbkgrnd,   bkgrndset,  wbkgrndset,  getbkgrnd,  wgetbkgrnd  -
+       manipulate background of a curses window of wide characters

SYNOPSIS

        #include <curses.h>
 
-       int bkgrnd( const cchar_t *wch);
-       int wbkgrnd( WINDOW *win, const cchar_t *wch);
+       int bkgrnd(const cchar_t *wch);
+       int wbkgrnd(WINDOW *win, const cchar_t *wch);
 
        void bkgrndset(const cchar_t *wch );
        void wbkgrndset(WINDOW *win, const cchar_t *wch);
@@ -100,22 +100,23 @@

getbkgrnd

        The getbkgrnd function returns the given  window's  current  background
-       character/attribute  pair  via  the  wch  pointer.  If the given window
-       pointer is null, the character is not updated (but no error returned).
+       character/attribute  pair  via  the  wch  pointer.  If the given window
+       pointer is null,  the  character  is  not  updated  (but  no  error  is
+       returned).

NOTES

        Note that bkgrnd, bkgrndset, and getbkgrnd may be macros.
 
        X/Open Curses does not provide details on how the rendition is changed.
-       This  implementation follows the approach used in SVr4 curses, which is
+       This implementation follows the approach used in SVr4 curses, which  is
        explained in the manual page for wbkgd.

RETURN VALUE

        The bkgrndset and wbkgrndset routines do not return a value.
 
-       Upon successful completion, the other functions return OK.   Otherwise,
+       Upon  successful completion, the other functions return OK.  Otherwise,
        they return ERR:
 
        o   A null window pointer is treated as an error.
@@ -124,7 +125,7 @@

PORTABILITY

-       These  functions  are  described  in  the  XSI Curses standard, Issue 4
+       These functions are described in  the  XSI  Curses  standard,  Issue  4
        (X/Open Curses).
 
 
@@ -133,7 +134,7 @@
 
 
 
-ncurses 6.4                       2023-08-12                   curs_bkgrnd(3x)
+ncurses 6.4                       2023-09-16                   curs_bkgrnd(3x)

curs_border 3x 2023-07-01 ncurses 6.4 Library calls

curs_border 3x 2023-09-16 ncurses 6.4 Library calls

curs_border 3x 2023-07-01 ncurses 6.4 Library calls

curs_border 3x 2023-09-16 ncurses 6.4 Library calls

 curs_border(3x)                  Library calls                 curs_border(3x)
 
@@ -47,9 +47,9 @@

NAME

-       border, wborder, box, hline, whline, vline, wvline, mvhline, mvwhline,
-       mvvline, mvwvline - create curses borders, horizontal and vertical
-       lines
+       border,  wborder, box, hline, whline, vline, wvline, mvhline, mvwhline,
+       mvvline, mvwvline - draw borders  and  lines  in  a  curses  window  of
+       characters

SYNOPSIS

@@ -76,8 +76,8 @@

DESCRIPTION

        The  border,  wborder and box routines draw a box around the edges of a
-       window.  Other than the window, each argument is a character  with  at-
-       tributes:
+       window.  Other than the window,  each  argument  is  a  character  with
+       attributes:
 
               ls - left side,
               rs - right side,
@@ -88,8 +88,8 @@
               bl - bottom left-hand corner, and
               br - bottom right-hand corner.
 
-       If  any of these arguments is zero, then the corresponding default val-
-       ues (defined in curses.h) are used instead:
+       If  any  of  these  arguments  is  zero, then the corresponding default
+       values (defined in curses.h) are used instead:
 
               ACS_VLINE,
               ACS_VLINE,
@@ -100,26 +100,26 @@
               ACS_LLCORNER,
               ACS_LRCORNER.
 
-       box(win, verch, horch) is a shorthand for  the  following  call:  wbor-
-       der(win, verch, verch, horch, horch, 0, 0, 0, 0).
+       box(win,  verch,  horch)  is  a  shorthand  for  the  following   call:
+       wborder(win, verch, verch, horch, horch, 0, 0, 0, 0).
 
        The  hline  and whline functions draw a horizontal (left to right) line
        using ch starting at the current cursor position in  the  window.   The
-       current  cursor position is not changed.  The line is at most n charac-
-       ters long, or as many as fit into the window.
+       current  cursor  position  is  not  changed.   The  line  is  at most n
+       characters long, or as many as fit into the window.
 
-       The vline and wvline functions draw a vertical (top to bottom) line us-
-       ing ch starting at the current cursor position in the window.  The cur-
-       rent cursor position is not changed.  The line is at most n  characters
-       long, or as many as fit into the window.
+       The vline and wvline functions draw a vertical  (top  to  bottom)  line
+       using  ch  starting  at the current cursor position in the window.  The
+       current cursor position  is  not  changed.   The  line  is  at  most  n
+       characters long, or as many as fit into the window.

RETURN VALUE

        All  routines return the integer OK.  The SVr4.0 manual says "or a non-
        negative integer if immedok is set", but this appears to be an error.
 
-       X/Open does not define any error conditions.  This  implementation  re-
-       turns an error if the window pointer is null.
+       X/Open does not  define  any  error  conditions.   This  implementation
+       returns an error if the window pointer is null.
 
        Functions  with  a  "mv"  prefix  first perform a cursor movement using
        wmove, and return an error if the position is outside the window, or if
@@ -144,7 +144,7 @@
 
 
 
-ncurses 6.4                       2023-07-01                   curs_border(3x)
+ncurses 6.4                       2023-09-16                   curs_border(3x)

curs_border_set 3x 2023-07-01 ncurses 6.4 Library calls

curs_border_set 3x 2023-09-16 ncurses 6.4 Library calls

curs_border_set 3x 2023-07-01 ncurses 6.4 Library calls

curs_border_set 3x 2023-09-16 ncurses 6.4 Library calls

 curs_border_set(3x)              Library calls             curs_border_set(3x)
 
@@ -47,9 +47,9 @@

NAME

-       border_set, wborder_set, box_set, hline_set, whline_set, mvhline_set,
-       mvwhline_set, vline_set, wvline_set, mvvline_set, mvwvline_set - create
-       curses borders or lines using complex characters and renditions
+       border_set,  wborder_set,  box_set, hline_set, whline_set, mvhline_set,
+       mvwhline_set, vline_set, wvline_set, mvvline_set, mvwvline_set  -  draw
+       borders and lines in a curses window of wide characters

SYNOPSIS

@@ -101,8 +101,8 @@
        of the current or specified window.  These functions do not change  the
        cursor position, and do not wrap.
 
-       Other  than  the  window, each argument is a complex character with at-
-       tributes:
+       Other  than  the  window,  each  argument  is  a complex character with
+       attributes:
               ls - left side,
               rs - right side,
               ts - top side,
@@ -112,8 +112,8 @@
               bl - bottom left-hand corner, and
               br - bottom right-hand corner.
 
-       If any of these arguments is zero, then the corresponding default  val-
-       ues (defined in curses.h) are used instead:
+       If any of these arguments  is  zero,  then  the  corresponding  default
+       values (defined in curses.h) are used instead:
               WACS_VLINE,
               WACS_VLINE,
               WACS_HLINE,
@@ -141,8 +141,8 @@

NOTES

-       Note  that  border_set,  hline_set,  mvhline_set,  mvvline_set,   mvwh-
-       line_set, mvwvline_set, and vline_set may be macros.
+       Note   that   border_set,    hline_set,    mvhline_set,    mvvline_set,
+       mvwhline_set, mvwvline_set, and vline_set may be macros.

RETURN VALUE

@@ -161,7 +161,7 @@
 
 
 
-ncurses 6.4                       2023-07-01               curs_border_set(3x)
+ncurses 6.4                       2023-09-16               curs_border_set(3x)

curs_clear 3x 2023-07-01 ncurses 6.4 Library calls

curs_clear 3x 2023-09-16 ncurses 6.4 Library calls

curs_clear 3x 2023-07-01 ncurses 6.4 Library calls

curs_clear 3x 2023-09-16 ncurses 6.4 Library calls

 curs_clear(3x)                   Library calls                  curs_clear(3x)
 
@@ -47,8 +47,8 @@

NAME

-       erase, werase, clear, wclear, clrtobot, wclrtobot, clrtoeol, wclrtoeol
-       - clear all or part of a curses window
+       erase,  werase, clear, wclear, clrtobot, wclrtobot, clrtoeol, wclrtoeol
+       - clear all or part of a curses window

SYNOPSIS

@@ -70,8 +70,8 @@

DESCRIPTION

erase/werase

-       The erase and werase routines copy blanks to every position in the win-
-       dow, clearing the screen.
+       The erase and werase routines copy blanks  to  every  position  in  the
+       window, clearing the screen.
 
        Blanks created by erasure have the current background rendition (as set
        by wbkgdset(3x)) merged into them.
@@ -116,19 +116,19 @@
        standard  specifies  that  they return ERR on failure, but specifies no
        error conditions.
 
-       The SVr4.0 manual says that these functions could return  "a  non-nega-
-       tive  integer  if immedok(3x) is set", referring to the return-value of
-       wrefresh.  In that implementation, wrefresh would return a count of the
-       number of characters written to the terminal.
+       The SVr4.0 manual says  that  these  functions  could  return  "a  non-
+       negative  integer if immedok(3x) is set", referring to the return-value
+       of wrefresh.  In that implementation, wrefresh would return a count  of
+       the number of characters written to the terminal.
 
        Some  historic  curses implementations had, as an undocumented feature,
-       the ability to do the equivalent of clearok(..., 1)  by  saying  touch-
-       win(stdscr) or clear(stdscr).  This will not work under ncurses.
+       the  ability  to  do  the  equivalent  of  clearok(...,  1)  by  saying
+       touchwin(stdscr) or clear(stdscr).  This will not work under ncurses.
 
-       This implementation, and others such as Solaris, sets the current posi-
-       tion to 0,0 after erasing via werase and wclear.  That fact is not doc-
-       umented  in  other  implementations, and may not be true of implementa-
-       tions which were not derived from SVr4 source.
+       This  implementation,  and  others  such  as  Solaris, sets the current
+       position to 0,0 after erasing via werase and wclear.  That fact is  not
+       documented   in   other   implementations,  and  may  not  be  true  of
+       implementations which were not derived from SVr4 source.
 
        Not obvious from the description, most implementations clear the screen
        after  wclear  even  for  a subwindow or derived window.  If you do not
@@ -140,7 +140,7 @@
 
 
 
-ncurses 6.4                       2023-07-01                    curs_clear(3x)
+ncurses 6.4                       2023-09-16                    curs_clear(3x)

curs_color 3x 2023-07-01 ncurses 6.4 Library calls

curs_color 3x 2023-09-16 ncurses 6.4 Library calls

curs_color 3x 2023-07-01 ncurses 6.4 Library calls

curs_color 3x 2023-09-16 ncurses 6.4 Library calls

 curs_color(3x)                   Library calls                  curs_color(3x)
 
@@ -47,10 +47,10 @@

NAME

-       start_color, has_colors, can_change_color, init_pair, init_color,
-       init_extended_pair, init_extended_color, color_content, pair_content,
-       extended_color_content, extended_pair_content, reset_color_pairs,
-       COLOR_PAIR, PAIR_NUMBER - curses color manipulation routines
+       start_color,   has_colors,   can_change_color,  init_pair,  init_color,
+       init_extended_pair, init_extended_color,  color_content,  pair_content,
+       extended_color_content,    extended_pair_content,    reset_color_pairs,
+       COLOR_PAIR, PAIR_NUMBER - manipulate terminal colors with curses

SYNOPSIS

@@ -87,24 +87,24 @@
        use  these  routines  start_color  must  be called, usually right after
        initscr.  Colors are always used in pairs (referred to as color-pairs).
        A  color-pair  consists  of  a  foreground color (for characters) and a
-       background color (for the blank field on which the characters are  dis-
-       played).   A  programmer  initializes  a  color-pair  with  the routine
+       background color (for the blank  field  on  which  the  characters  are
+       displayed).   A  programmer  initializes  a color-pair with the routine
        init_pair.  After it has been initialized, COLOR_PAIR(n) can be used to
        convert the pair to a video attribute.
 
        If  a  terminal is capable of redefining colors, the programmer can use
-       the routine init_color to change the definition of a color.   The  rou-
-       tines  has_colors  and can_change_color return TRUE or FALSE, depending
-       on whether the terminal has color capabilities and whether the program-
-       mer can change the colors.  The routine color_content allows a program-
-       mer to extract the amounts of red, green, and  blue  components  in  an
-       initialized  color.   The  routine  pair_content allows a programmer to
-       find out how a given color-pair is currently defined.
+       the routine init_color to  change  the  definition  of  a  color.   The
+       routines   has_colors   and  can_change_color  return  TRUE  or  FALSE,
+       depending on whether the terminal has color  capabilities  and  whether
+       the programmer can change the colors.  The routine color_content allows
+       a programmer to extract the amounts of red, green, and blue  components
+       in  an initialized color.  The routine pair_content allows a programmer
+       to find out how a given color-pair is currently defined.

Color Rendering

-       The curses library combines these inputs to produce  the  actual  fore-
-       ground and background colors shown on the screen:
+       The  curses  library  combines  these  inputs  to  produce  the  actual
+       foreground and background colors shown on the screen:
 
        o   per-character video attributes (e.g., via waddch),
 
@@ -112,10 +112,10 @@
 
        o   the background character (e.g., wbkgdset).
 
-       Per-character and window attributes are usually set by a parameter con-
-       taining video attributes including a color pair value.  Some  functions
-       such as wattr_set use a separate parameter which is the color pair num-
-       ber.
+       Per-character  and  window  attributes  are  usually set by a parameter
+       containing  video  attributes  including  a  color  pair  value.   Some
+       functions such as wattr_set use a separate parameter which is the color
+       pair number.
 
        The background character is a special case:  it  includes  a  character
        value, just as if it were passed to waddch.
@@ -135,12 +135,12 @@
 
        o   If the parameter passed to waddch is not blank, or it does not  use
            the  special  color  pair 0, curses prefers the color pair from the
-           parameter, if it is nonzero.  Otherwise, it tries the window attri-
-           bute next, and finally the background character.
+           parameter, if it  is  nonzero.   Otherwise,  it  tries  the  window
+           attribute next, and finally the background character.
 
-       Some  curses  functions such as wprintw call waddch.  Those do not com-
-       bine its parameter with a color pair.  Consequently those calls use on-
-       ly the window attribute or the background character.
+       Some  curses  functions  such  as  wprintw  call  waddch.  Those do not
+       combine its parameter with a color pair.  Consequently those calls  use
+       only the window attribute or the background character.

CONSTANTS

@@ -164,8 +164,8 @@

VARIABLES

COLORS

-       is initialized by start_color to the maximum number of colors the  ter-
-       minal can support.
+       is initialized by start_color to  the  maximum  number  of  colors  the
+       terminal can support.

COLOR_PAIRS

@@ -177,12 +177,12 @@

start_color

        The start_color routine requires no arguments.  It must  be  called  if
-       the  programmer wants to use colors, and before any other color manipu-
-       lation routine is called.  It is good practice  to  call  this  routine
-       right after initscr.  start_color does this:
+       the  programmer  wants  to  use  colors,  and  before  any  other color
+       manipulation routine is called.  It  is  good  practice  to  call  this
+       routine right after initscr.  start_color does this:
 
-       o   It  initializes  two  global variables, COLORS and COLOR_PAIRS (re-
-           spectively defining the maximum number of  colors  and  color-pairs
+       o   It   initializes  two  global  variables,  COLORS  and  COLOR_PAIRS
+           (respectively defining the maximum number of colors and color-pairs
            the terminal can support).
 
        o   It  initializes  the special color pair 0 to the default foreground
@@ -209,77 +209,77 @@
            initial eight colors.
 
            start_color does not attempt to set the terminal's color palette to
-           match its built-in table.  An application may use init_color to al-
-           ter the internal table along with the terminal's color.
+           match  its  built-in  table.   An application may use init_color to
+           alter the internal table along with the terminal's color.
 
        These limits apply to color values and  color  pairs.   Values  outside
        these limits are not legal, and may result in a runtime error:
 
-       o   COLORS  corresponds to the terminal database's max_colors capabili-
-           ty, (see terminfo(5)).
+       o   COLORS   corresponds   to   the   terminal   database's  max_colors
+           capability, (see terminfo(5)).
 
-       o   color values are expected to be in the range 0 to COLORS-1,  inclu-
-           sive (including 0 and COLORS-1).
+       o   color values are expected  to  be  in  the  range  0  to  COLORS-1,
+           inclusive (including 0 and COLORS-1).
 
        o   a  special  color value -1 is used in certain extended functions to
            denote the default color (see use_default_colors(3x)).
 
-       o   COLOR_PAIRS corresponds to the terminal database's max_pairs  capa-
-           bility, (see terminfo(5)).
+       o   COLOR_PAIRS  corresponds  to  the  terminal  database's   max_pairs
+           capability, (see terminfo(5)).
 
-       o   legal color pair values are in the range 1 to COLOR_PAIRS-1, inclu-
-           sive.
+       o   legal  color  pair  values  are  in  the  range 1 to COLOR_PAIRS-1,
+           inclusive.
 
        o   color pair 0 is special; it denotes "no color".
 
-           Color pair 0 is assumed to be white on black, but is actually what-
-           ever  the terminal implements before color is initialized.  It can-
-           not be modified by the application.
+           Color pair 0 is assumed to be  white  on  black,  but  is  actually
+           whatever  the  terminal implements before color is initialized.  It
+           cannot be modified by the application.

has_colors

        The has_colors routine requires no arguments.  It returns TRUE  if  the
-       terminal can manipulate colors; otherwise, it returns FALSE.  This rou-
-       tine facilitates writing terminal-independent programs.  For example, a
-       programmer  can  use  it  to  decide whether to use color or some other
-       video attribute.
+       terminal  can  manipulate  colors;  otherwise,  it returns FALSE.  This
+       routine  facilitates  writing   terminal-independent   programs.    For
+       example, a programmer can use it to decide whether to use color or some
+       other video attribute.

can_change_color

        The can_change_color routine requires no arguments.  It returns TRUE if
        the  terminal  supports colors and can change their definitions; other,
-       it returns FALSE.  This routine facilitates  writing  terminal-indepen-
-       dent programs.
+       it  returns  FALSE.   This  routine   facilitates   writing   terminal-
+       independent programs.

init_pair

        The init_pair routine changes the definition of a color-pair.  It takes
-       three arguments: the number of the color-pair to be changed, the  fore-
-       ground color number, and the background color number.  For portable ap-
-       plications:
+       three arguments: the number  of  the  color-pair  to  be  changed,  the
+       foreground color number, and the background color number.  For portable
+       applications:
 
        o   The first argument must be a legal color pair  value.   If  default
-           colors are used (see use_default_colors(3x)) the upper limit is ad-
-           justed to allow for extra pairs which use a default color in  fore-
-           ground and/or background.
+           colors  are  used  (see  use_default_colors(3x)) the upper limit is
+           adjusted to allow for extra pairs which  use  a  default  color  in
+           foreground and/or background.
 
        o   The second and third arguments must be legal color values.
 
        If  the  color-pair was previously initialized, the screen is refreshed
-       and all occurrences of that color-pair are changed to the  new  defini-
-       tion.
+       and  all  occurrences  of  that  color-pair  are  changed  to  the  new
+       definition.
 
-       As  an  extension,  ncurses  allows you to set color pair 0 via the as-
-       sume_default_colors(3x) routine, or to specify the use of default  col-
-       ors  (color  number  -1) if you first invoke the use_default_colors(3x)
+       As  an  extension,  ncurses  allows  you  to  set  color pair 0 via the
+       assume_default_colors(3x) routine, or to specify  the  use  of  default
+       colors (color number -1) if you first invoke the use_default_colors(3x)
        routine.

init_extended_pair

        Because init_pair uses signed shorts for its  parameters,  that  limits
-       color-pairs  and  color-values to 32767 on modern hardware.  The exten-
-       sion init_extended_pair uses ints for the color-pair  and  color-value,
-       allowing a larger number of colors to be supported.
+       color-pairs   and  color-values  to  32767  on  modern  hardware.   The
+       extension init_extended_pair uses ints for the  color-pair  and  color-
+       value, allowing a larger number of colors to be supported.

init_color

@@ -300,18 +300,18 @@

init_extended_color

        Because  init_color  uses signed shorts for its parameters, that limits
-       color-values and their red, green, and blue components to 32767 on mod-
-       ern hardware.  The extension init_extended_color uses ints for the col-
-       or value and for setting the red, green, and blue components,  allowing
-       a larger number of colors to be supported.
+       color-values and their red, green, and  blue  components  to  32767  on
+       modern  hardware.   The extension init_extended_color uses ints for the
+       color value and for  setting  the  red,  green,  and  blue  components,
+       allowing a larger number of colors to be supported.

color_content

        The color_content routine gives programmers a way to find the intensity
        of the red, green, and blue (RGB) components in a color.   It  requires
        four  arguments:  the  color  number, and three addresses of shorts for
-       storing the information about the amounts of red, green, and blue  com-
-       ponents in the given color.
+       storing the information about the  amounts  of  red,  green,  and  blue
+       components in the given color.
 
        o   The  first  argument  must  be a legal color value, i.e., 0 through
            COLORS-1, inclusive.
@@ -322,9 +322,9 @@

extended_color_content

-       Because color_content uses signed shorts for its parameters, that  lim-
-       its  color-values and their red, green, and blue components to 32767 on
-       modern hardware.  The extension extended_color_content  uses  ints  for
+       Because color_content uses  signed  shorts  for  its  parameters,  that
+       limits  color-values and their red, green, and blue components to 32767
+       on modern hardware.  The extension extended_color_content uses ints for
        the  color value and for returning the red, green, and blue components,
        allowing a larger number of colors to be supported.
 
@@ -338,17 +338,17 @@
        o   The  first argument must be a legal color value, i.e., in the range
            1 through COLOR_PAIRS-1, inclusive.
 
-       o   The values that are stored at the addresses pointed to by the  sec-
-           ond  and  third arguments are in the range 0 through COLORS, inclu-
-           sive.
+       o   The values that are stored at  the  addresses  pointed  to  by  the
+           second  and  third  arguments  are  in  the range 0 through COLORS,
+           inclusive.

extended_pair_content

        Because pair_content uses signed shorts for its parameters, that limits
        color-pair and color-values to 32767 on modern hardware.  The extension
        extended_pair_content uses ints for the color pair  and  for  returning
-       the  foreground and background colors, allowing a larger number of col-
-       ors to be supported.
+       the  foreground  and  background  colors,  allowing  a larger number of
+       colors to be supported.

reset_color_pairs

@@ -375,27 +375,28 @@
        The routines can_change_color and has_colors return TRUE or FALSE.
 
        All other routines return the integer ERR upon failure and an OK  (SVr4
-       specifies  only "an integer value other than ERR") upon successful com-
-       pletion.
+       specifies  only  "an  integer  value  other  than ERR") upon successful
+       completion.
 
-       X/Open defines no error conditions.  SVr4 does document some error con-
-       ditions which apply in general:
+       X/Open defines no error conditions.   SVr4  does  document  some  error
+       conditions which apply in general:
 
        o   This implementation will return ERR on attempts to use color values
-           outside the range 0 to COLORS-1 (except for the default colors  ex-
-           tension), or use color pairs outside the range 0 to COLOR_PAIRS-1.
+           outside the range 0 to COLORS-1  (except  for  the  default  colors
+           extension),   or   use   color   pairs   outside  the  range  0  to
+           COLOR_PAIRS-1.
 
            Color values used in init_color must be in the range 0 to 1000.
 
-           An  error  is  returned  from all functions if the terminal has not
+           An error is returned from all functions if  the  terminal  has  not
            been initialized.
 
-           An error is returned from secondary functions such as init_pair  if
+           An  error is returned from secondary functions such as init_pair if
            start_color was not called.
 
-       o   SVr4  does much the same, except that it returns ERR from pair_con-
-           tent if the pair was not initialized using init_pairs  and  it  re-
-           turns  ERR  from  color_content  if  the  terminal does not support
+       o   SVr4  does  much  the  same,  except  that  it  returns  ERR   from
+           pair_content  if  the pair was not initialized using init_pairs and
+           it returns ERR from color_content if the terminal does not  support
            changing colors.
 
            This implementation does not return ERR for either case.
@@ -404,7 +405,7 @@
 
           init_color
                returns an error if the terminal does not support this feature,
-               e.g.,  if  the  initialize_color  capability is absent from the
+               e.g., if the initialize_color capability  is  absent  from  the
                terminal description.
 
           start_color
@@ -412,28 +413,28 @@

NOTES

-       In the ncurses implementation, there is  a  separate  color  activation
-       flag,  color palette, color pairs table, and associated COLORS and COL-
-       OR_PAIRS counts for each screen; the start_color function only  affects
-       the current screen.  The SVr4/XSI interface is not really designed with
-       this in mind, and historical implementations may use  a  single  shared
-       color palette.
-
-       Setting  an  implicit  background  color  via a color pair affects only
-       character cells that a character write  operation  explicitly  touches.
-       To  change the background color used when parts of a window are blanked
+       In  the  ncurses  implementation,  there is a separate color activation
+       flag, color palette, color  pairs  table,  and  associated  COLORS  and
+       COLOR_PAIRS  counts  for  each  screen;  the  start_color function only
+       affects the current screen.   The  SVr4/XSI  interface  is  not  really
+       designed  with  this  in mind, and historical implementations may use a
+       single shared color palette.
+
+       Setting an implicit background color via  a  color  pair  affects  only
+       character  cells  that  a character write operation explicitly touches.
+       To change the background color used when parts of a window are  blanked
        by erasing or scrolling operations, see curs_bkgd(3x).
 
-       Several caveats apply on older x86 machines  (e.g.,  i386,  i486)  with
+       Several  caveats  apply  on  older x86 machines (e.g., i386, i486) with
        VGA-compatible graphics:
 
-       o   COLOR_YELLOW  is  actually  brown.  To get yellow, use COLOR_YELLOW
+       o   COLOR_YELLOW is actually brown.  To get  yellow,  use  COLOR_YELLOW
            combined with the A_BOLD attribute.
 
-       o   The A_BLINK attribute should in theory cause the background  to  go
+       o   The  A_BLINK  attribute should in theory cause the background to go
            bright.  This often fails to work, and even some cards for which it
-           mostly works (such as the Paradise and compatibles)  do  the  wrong
-           thing  when  you try to set a bright "yellow" background (you get a
+           mostly  works  (such  as the Paradise and compatibles) do the wrong
+           thing when you try to set a bright "yellow" background (you  get  a
            blinking yellow foreground instead).
 
        o   Color RGB values are not settable.
@@ -442,89 +443,89 @@

HISTORY

        SVr3.2 introduced color support to curses in 1987.
 
-       SVr4 made internal changes, e.g., moving  the  storage  for  the  color
-       state  from  SP (the SCREEN structure) to cur_term (the TERMINAL struc-
-       ture), but provided the same set of library functions.
+       SVr4  made  internal  changes,  e.g.,  moving the storage for the color
+       state  from  SP  (the  SCREEN  structure)  to  cur_term  (the  TERMINAL
+       structure), but provided the same set of library functions.
 
-       SVr4 curses limits the number of color pairs  to  64,  reserving  color
-       pair  zero  (0)  as the terminal's initial uncolored state.  This limit
-       arises because the color pair information is a bitfield in  the  chtype
+       SVr4  curses  limits  the  number of color pairs to 64, reserving color
+       pair zero (0) as the terminal's initial uncolored  state.   This  limit
+       arises  because  the color pair information is a bitfield in the chtype
        data type (denoted by A_COLOR).
 
        Other implementations of curses had different limits:
 
        o   PCCurses (1987-1990) provided for only eight (8) colors.
 
-       o   PDCurses  (1992-present)  inherited the 8-color limitation from PC-
-           Curses, but changed this to 256 in version 2.5 (2001),  along  with
+       o   PDCurses  (1992-present)  inherited  the  8-color  limitation  from
+           PCCurses, but changed this to 256 in version 2.5 (2001), along with
            changing chtype from 16-bits to 32-bits.
 
        o   X/Open Curses (1992-present) added a new structure cchar_t to store
            the character, attributes and color-pair values, allowing increased
-           range  of  color-pairs.   Both  color-pairs and color-values used a
+           range of color-pairs.  Both color-pairs  and  color-values  used  a
            signed short, limiting values to 15 bits.
 
-       o   ncurses (1992-present) uses eight bits for A_COLOR in  chtype  val-
-           ues.
+       o   ncurses  (1992-present)  uses  eight  bits  for  A_COLOR  in chtype
+           values.
 
-           Version  5.3  provided  a wide-character interface (2002), but left
+           Version 5.3 provided a wide-character interface  (2002),  but  left
            color-pairs as part of the attributes-field.
 
            Since version 6 (2015), ncurses uses a separate int for color-pairs
            in the cchar_t values.  When those color-pair values fit in 8 bits,
-           ncurses allows color-pairs to be manipulated via the functions  us-
-           ing chtype values.
+           ncurses  allows  color-pairs  to  be  manipulated via the functions
+           using chtype values.
 
-       o   NetBSD  curses  used  6 bits from 2000 (when colors were first sup-
-           ported) until 2004.  At that point, NetBSD changed to use 10  bits.
-           As of 2021, that size is unchanged.  Like ncurses before version 6,
-           the NetBSD color-pair information is stored in the attributes field
-           of  cchar_t,  limiting the number of color-pairs by the size of the
-           bitfield.
+       o   NetBSD curses used  6  bits  from  2000  (when  colors  were  first
+           supported)  until  2004.   At  that point, NetBSD changed to use 10
+           bits.  As of 2021, that size is  unchanged.   Like  ncurses  before
+           version  6,  the  NetBSD  color-pair  information  is stored in the
+           attributes field of cchar_t, limiting the number of color-pairs  by
+           the size of the bitfield.

PORTABILITY

Extensions

-       The functions marked as extensions were designed for  ncurses(3x),  and
-       are not found in SVr4 curses, 4.4BSD curses, or any other previous ver-
-       sion of curses.
+       The  functions  marked as extensions were designed for ncurses(3x), and
+       are not found in SVr4 curses, 4.4BSD  curses,  or  any  other  previous
+       version of curses.

Standards

-       This implementation satisfies XSI Curses's minimum maximums for  COLORS
+       This  implementation satisfies XSI Curses's minimum maximums for COLORS
        and COLOR_PAIRS.
 
-       The  init_pair  routine accepts negative values of foreground and back-
-       ground color to support the use_default_colors(3x) extension, but  only
-       if that routine has been first invoked.
+       The  init_pair  routine  accepts  negative  values  of  foreground  and
+       background  color  to support the use_default_colors(3x) extension, but
+       only if that routine has been first invoked.
 
        The assumption that COLOR_BLACK is the default background color for all
-       terminals can be modified using  the  assume_default_colors(3x)  exten-
-       sion.
+       terminals   can   be   modified   using  the  assume_default_colors(3x)
+       extension.
 
-       This  implementation checks the pointers, e.g., for the values returned
-       by color_content and pair_content, and will treat those as optional pa-
-       rameters when null.
+       This implementation checks the pointers, e.g., for the values  returned
+       by  color_content  and  pair_content,  and will treat those as optional
+       parameters when null.
 
-       X/Open  Curses  does  not  specify a limit for the number of colors and
+       X/Open Curses does not specify a limit for the  number  of  colors  and
        color pairs which a terminal can support.  However, in its use of short
-       for  the  parameters,  it carries over SVr4's implementation detail for
+       for the parameters, it carries over SVr4's  implementation  detail  for
        the compiled terminfo database, which uses signed 16-bit numbers.  This
-       implementation  provides extended versions of those functions which use
-       short parameters, allowing applications to use larger color- and  pair-
+       implementation provides extended versions of those functions which  use
+       short  parameters, allowing applications to use larger color- and pair-
        numbers.
 
        The reset_color_pairs function is an extension of ncurses.

curs_delch 3x 2023-07-01 ncurses 6.4 Library calls

curs_delch 3x 2023-09-16 ncurses 6.4 Library calls

 curs_delch(3x)                   Library calls                  curs_delch(3x)
 
@@ -47,8 +47,8 @@

NAME

-       delch, wdelch, mvdelch, mvwdelch - delete character under the cursor in
-       a curses window
+       delch,  wdelch,  mvdelch, mvwdelch - delete the character at the cursor
+       in a curses window

SYNOPSIS

@@ -94,7 +94,7 @@
 
 
 
-ncurses 6.4                       2023-07-01                    curs_delch(3x)
+ncurses 6.4                       2023-09-16                    curs_delch(3x)

curs_deleteln 3x 2023-07-01 ncurses 6.4 Library calls

curs_deleteln 3x 2023-09-16 ncurses 6.4 Library calls

curs_deleteln 3x 2023-07-01 ncurses 6.4 Library calls

curs_deleteln 3x 2023-09-16 ncurses 6.4 Library calls

 curs_deleteln(3x)                Library calls               curs_deleteln(3x)
 
@@ -48,7 +48,7 @@

NAME

        deleteln,  wdeleteln, insdelln, winsdelln, insertln, winsertln - delete
-       and insert lines in a curses window
+       or insert lines in a curses window

SYNOPSIS

@@ -109,7 +109,7 @@
 
 
 
-ncurses 6.4                       2023-07-01                 curs_deleteln(3x)
+ncurses 6.4                       2023-09-16                 curs_deleteln(3x)

curs_extend 3x 2023-07-01 ncurses 6.4 Library calls

curs_extend 3x 2023-09-16 ncurses 6.4 Library calls

curs_extend 3x 2023-07-01 ncurses 6.4 Library calls

curs_extend 3x 2023-09-16 ncurses 6.4 Library calls

 curs_extend(3x)                  Library calls                 curs_extend(3x)
 
@@ -48,7 +48,7 @@

NAME

-       curses_version, use_extended_names - miscellaneous curses extensions
+       curses_version, use_extended_names - miscellaneous curses extensions

SYNOPSIS

@@ -105,7 +105,7 @@
 
 
 
-ncurses 6.4                       2023-07-01                   curs_extend(3x)
+ncurses 6.4                       2023-09-16                   curs_extend(3x)

curs_get_wch 3x 2022-02-12 ncurses 6.4 Library calls

curs_get_wch 3x 2023-09-16 ncurses 6.4 Library calls

curs_get_wch 3x 2022-02-12 ncurses 6.4 Library calls

curs_get_wch 3x 2023-09-16 ncurses 6.4 Library calls

 curs_get_wch(3x)                 Library calls                curs_get_wch(3x)
 
@@ -47,8 +47,8 @@

NAME

-       get_wch, wget_wch, mvget_wch, mvwget_wch, unget_wch - get (or push
-       back) a wide character from curses terminal keyboard
+       get_wch,  wget_wch,  mvget_wch,  mvwget_wch,  unget_wch  - get (or push
+       back) a wide character from curses terminal keyboard

SYNOPSIS

@@ -65,14 +65,14 @@

DESCRIPTION

wget_wch

-       The get_wch, wget_wch, mvget_wch, and mvwget_wch functions read a char-
-       acter  from  the terminal associated with the current or specified win-
-       dow.  In no-delay mode, if no input is waiting, the value  ERR  is  re-
-       turned.   In delay mode, the program waits until the system passes text
-       through to the program.  Depending on the setting of  cbreak,  this  is
-       after one character (cbreak mode), or after the first newline (nocbreak
-       mode).  In half-delay mode, the program waits until the  user  types  a
-       character or the specified timeout interval has elapsed.
+       The get_wch, wget_wch,  mvget_wch,  and  mvwget_wch  functions  read  a
+       character  from  the  terminal associated with the current or specified
+       window.  In no-delay mode, if no input is waiting,  the  value  ERR  is
+       returned.   In  delay  mode,  the program waits until the system passes
+       text through to the program.  Depending on the setting of cbreak,  this
+       is  after  one  character  (cbreak  mode),  or  after the first newline
+       (nocbreak mode).  In half-delay mode, the program waits until the  user
+       types a character or the specified timeout interval has elapsed.
 
        Unless  noecho has been set, these routines echo the character into the
        designated window.
@@ -82,38 +82,40 @@
        is read.
 
        If keypad is enabled, these functions respond  to  the  pressing  of  a
-       function key by setting the object pointed to by wch to the keycode as-
-       signed to the function key, and returning KEY_CODE_YES.  If a character
-       (such  as  escape) that could be the beginning of a function key is re-
-       ceived, curses sets a timer.  If the remainder of the sequence does ar-
-       rive  within  the designated time, curses passes through the character;
-       otherwise, curses returns the function key  value.   For  this  reason,
-       many  terminals  experience a delay between the time a user presses the
-       escape key and the time the escape is returned to the program.
+       function  key  by  setting  the object pointed to by wch to the keycode
+       assigned to  the  function  key,  and  returning  KEY_CODE_YES.   If  a
+       character  (such  as  escape) that could be the beginning of a function
+       key is received, curses sets a timer.  If the remainder of the sequence
+       does  arrive  within  the  designated  time,  curses passes through the
+       character; otherwise, curses returns the function key value.  For  this
+       reason,  many  terminals  experience  a  delay  between the time a user
+       presses the escape key and the time  the  escape  is  returned  to  the
+       program.
 
        The keycodes returned by these functions are the same as those returned
        by wgetch:
 
-       o   The  predefined  function  keys  are listed in <curses.h> as macros
-           with values outside the range of 8-bit characters.  Their names be-
-           gin with KEY_.
+       o   The predefined function keys are listed  in  <curses.h>  as  macros
+           with  values  outside  the  range of 8-bit characters.  Their names
+           begin with KEY_.
 
-       o   Other  (user-defined)  function keys which may be defined using de-
-           fine_key(3x) have no names, but also are expected  to  have  values
+       o   Other (user-defined) function  keys  which  may  be  defined  using
+           define_key(3x)  have no names, but also are expected to have values
            outside the range of 8-bit characters.

unget_wch

        The unget_wch function pushes the wide character wch back onto the head
-       of the input queue, so the wide character is returned by the next  call
-       to  get_wch.  The pushback of one character is guaranteed.  If the pro-
-       gram calls unget_wch too many times  without  an  intervening  call  to
+       of  the input queue, so the wide character is returned by the next call
+       to get_wch.  The pushback of  one  character  is  guaranteed.   If  the
+       program  calls  unget_wch too many times without an intervening call to
        get_wch, the operation may fail.
 
-       Unlike ungetch and wgetch, unget_wch cannot distinguish special charac-
-       ters returned by wget_wch from ordinary characters.  An application can
-       push  special  keys  which it may read via wget_wch by checking for the
-       KEY_CODE_YES result, and using ungetch for those special keys.
+       Unlike  ungetch  and  wgetch,  unget_wch  cannot  distinguish   special
+       characters   returned   by   wget_wch  from  ordinary  characters.   An
+       application can push special keys which it may  read  via  wget_wch  by
+       checking  for  the  KEY_CODE_YES  result,  and  using ungetch for those
+       special keys.

NOTES

@@ -125,20 +127,20 @@
 
        When using get_wch, wget_wch, mvget_wch,  or  mvwget_wch,  applications
        should not use nocbreak mode and echo mode at the same time.  Depending
-       on the state of the tty driver when each character is typed,  the  pro-
-       gram may produce undesirable results.
+       on the state of the tty  driver  when  each  character  is  typed,  the
+       program may produce undesirable results.
 
        All functions except wget_wch and unget_wch may be macros.

RETURN VALUE

-       When get_wch, wget_wch, mvget_wch, and mvwget_wch functions successful-
-       ly report the pressing of a function  key,  they  return  KEY_CODE_YES.
-       When they successfully report a wide character, they return OK.  Other-
-       wise, they return ERR.
+       When   get_wch,   wget_wch,   mvget_wch,   and   mvwget_wch   functions
+       successfully report  the  pressing  of  a  function  key,  they  return
+       KEY_CODE_YES.   When  they  successfully  report a wide character, they
+       return OK.  Otherwise, they return ERR.
 
-       Upon successful completion, unget_wch returns OK.  Otherwise, the func-
-       tion returns ERR.
+       Upon successful  completion,  unget_wch  returns  OK.   Otherwise,  the
+       function returns ERR.
 
        Functions  with  a  "mv"  prefix  first perform a cursor movement using
        wmove, and return an error if the position is outside the window, or if
@@ -151,7 +153,7 @@
 
 
 
-ncurses 6.4                       2022-02-12                  curs_get_wch(3x)
+ncurses 6.4                       2023-09-16                  curs_get_wch(3x)

curs_get_wstr 3x 2023-08-05 ncurses 6.4 Library calls

curs_get_wstr 3x 2023-09-16 ncurses 6.4 Library calls

curs_get_wstr 3x 2023-08-05 ncurses 6.4 Library calls

curs_get_wstr 3x 2023-09-16 ncurses 6.4 Library calls

 curs_get_wstr(3x)                Library calls               curs_get_wstr(3x)
 
@@ -47,9 +47,9 @@

NAME

-       get_wstr, getn_wstr, wget_wstr, wgetn_wstr, mvget_wstr, mvgetn_wstr,
-       mvwget_wstr, mvwgetn_wstr - get an array of wide characters from a
-       curses terminal keyboard
+       get_wstr,  getn_wstr,  wget_wstr,  wgetn_wstr, mvget_wstr, mvgetn_wstr,
+       mvwget_wstr, mvwgetn_wstr - get a wide-character string from  a  curses
+       terminal keyboard

SYNOPSIS

@@ -101,30 +101,31 @@
            cursor at the beginning of the buffer.
 
        Characters input are echoed only if echo  is  currently  on.   In  that
-       case,  backspace is echoed as deletion of the previous character (typi-
-       cally a left motion).
+       case,  backspace  is  echoed  as  deletion  of  the  previous character
+       (typically a left motion).
 
        The getn_wstr, mvgetn_wstr, mvwgetn_wstr, and wgetn_wstr functions  are
-       identical to the get_wstr, mvget_wstr, mvwget_wstr, and wget_wstr func-
-       tions, respectively, except that the *n_* versions read at most n char-
-       acters, letting the application prevent overflow of the input buffer.
+       identical  to  the  get_wstr,  mvget_wstr,  mvwget_wstr,  and wget_wstr
+       functions, respectively, except that the *n_* versions read at  most  n
+       characters,  letting  the  application  prevent  overflow  of the input
+       buffer.

NOTES

        Any of these functions other than wgetn_wstr may be macros.
 
-       Using  get_wstr,  mvget_wstr,  mvwget_wstr, or wget_wstr to read a line
-       that overflows the array pointed to by wstr causes  undefined  results.
-       The use of getn_wstr, mvgetn_wstr, mvwgetn_wstr, or wgetn_wstr, respec-
-       tively, is recommended.
+       Using get_wstr, mvget_wstr, mvwget_wstr, or wget_wstr to  read  a  line
+       that  overflows  the array pointed to by wstr causes undefined results.
+       The  use  of  getn_wstr,  mvgetn_wstr,  mvwgetn_wstr,  or   wgetn_wstr,
+       respectively, is recommended.
 
-       These functions cannot return KEY_ values because there is  no  way  to
+       These  functions  cannot  return KEY_ values because there is no way to
        distinguish a KEY_ value from a valid wchar_t value.  may be macros.

RETURN VALUE

-       All  of  these  functions return the integer OK upon successful comple-
-       tion.  If unsuccessful, they return ERR.
+       All  of  these  functions  return  the  integer  OK   upon   successful
+       completion.  If unsuccessful, they return ERR.
 
        X/Open defines no error conditions.
 
@@ -136,7 +137,7 @@
 
        o   if the associated call to wget_wch failed.
 
-       Functions with a "mv" prefix first  perform  a  cursor  movement  using
+       Functions  with  a  "mv"  prefix  first perform a cursor movement using
        wmove, and return an error if the position is outside the window, or if
        the window pointer is null.
 
@@ -145,39 +146,39 @@
        These functions are described in The Single Unix Specification, Version
        2.  No error conditions are defined.
 
-       This  implementation  returns  ERR if the window pointer is null, or if
-       the lower-level wget_wch call returns an ERR.  In the latter  case,  an
-       ERR  return  without other data is treated as an end-of-file condition,
+       This implementation returns ERR if the window pointer is  null,  or  if
+       the  lower-level  wget_wch call returns an ERR.  In the latter case, an
+       ERR return without other data is treated as an  end-of-file  condition,
        and the returned array contains a WEOF followed by a null wchar_t.
 
        X/Open curses documented these functions to pass an array of wchar_t in
        1997, but that was an error because of this part of the description:
 
               The effect of get_wstr is as though a series of calls to get_wch
-              were made, until a newline character, end-of-line character,  or
+              were  made, until a newline character, end-of-line character, or
               end-of-file character is processed.
 
-       The  latter function get_wch can return a negative value, while wchar_t
-       is a unsigned type.  All of the vendors implement  this  using  wint_t,
+       The latter function get_wch can return a negative value, while  wchar_t
+       is  a  unsigned  type.  All of the vendors implement this using wint_t,
        following the standard.
 
-       X/Open  Curses,  Issue 7 (2009) is unclear regarding whether the termi-
-       nating null wchar_t value is counted in the length parameter n.  X/Open
-       Curses,  Issue  7  revised the corresponding description of wgetnstr to
-       address this issue.  The unrevised description of wget_nwstr can be in-
-       terpreted either way.  This implementation counts the terminator in the
-       length.
+       X/Open  Curses,  Issue  7  (2009)  is  unclear  regarding  whether  the
+       terminating  null  wchar_t  value is counted in the length parameter n.
+       X/Open  Curses,  Issue  7  revised  the  corresponding  description  of
+       wgetnstr   to   address  this  issue.   The  unrevised  description  of
+       wget_nwstr can be interpreted either way.  This  implementation  counts
+       the terminator in the length.
 
-       X/Open Curses does not specify what happens if the length  n  is  nega-
-       tive.
+       X/Open  Curses  does  not  specify  what  happens  if  the  length n is
+       negative.
 
-       o   For  analogy  with  wgetnstr,  ncurses  6.2  uses a limit (based on
+       o   For analogy with wgetnstr, ncurses  6.2  uses  a  limit  (based  on
            LINE_MAX).
 
-       o   Some other implementations (such as Solaris xcurses) do  the  same,
+       o   Some  other  implementations (such as Solaris xcurses) do the same,
            while others (PDCurses) do not allow this.
 
-       o   NetBSD  7 curses imitates ncurses 6.1 in this regard, treating a -1
+       o   NetBSD 7 curses imitates ncurses 6.1 in this regard, treating a  -1
            as an indefinite number of characters.
 
 
@@ -186,7 +187,7 @@
 
 
 
-ncurses 6.4                       2023-08-05                 curs_get_wstr(3x)
+ncurses 6.4                       2023-09-16                 curs_get_wstr(3x)

curs_getcchar 3x 2023-07-01 ncurses 6.4 Library calls

curs_getcchar 3x 2023-09-16 ncurses 6.4 Library calls

curs_getcchar 3x 2023-07-01 ncurses 6.4 Library calls

curs_getcchar 3x 2023-09-16 ncurses 6.4 Library calls

 curs_getcchar(3x)                Library calls               curs_getcchar(3x)
 
@@ -47,8 +47,8 @@

NAME

-       getcchar,  setcchar  - Get a wide character string and rendition from a
-       cchar_t or set a cchar_t from a wide-character string
+       getcchar,  setcchar  -  convert  between  a wide-character string and a
+       curses complex character string

SYNOPSIS

@@ -196,7 +196,7 @@
 
 
 
-ncurses 6.4                       2023-07-01                 curs_getcchar(3x)
+ncurses 6.4                       2023-09-16                 curs_getcchar(3x)

curs_getch 3x 2023-08-19 ncurses 6.4 Library calls

curs_getch 3x 2023-09-16 ncurses 6.4 Library calls

curs_getch 3x 2023-08-19 ncurses 6.4 Library calls

curs_getch 3x 2023-09-16 ncurses 6.4 Library calls

 curs_getch(3x)                   Library calls                  curs_getch(3x)
 
@@ -49,7 +49,7 @@

NAME

        getch, wgetch, mvgetch, mvwgetch, ungetch, has_key - get (or push back)
-       characters from curses terminal keyboard
+       characters from curses terminal keyboard

SYNOPSIS

@@ -75,19 +75,19 @@
        returned.  In delay mode, the program waits  until  the  system  passes
        text  through to the program.  Depending on the setting of cbreak, this
        is after one character  (cbreak  mode),  or  after  the  first  newline
-       (nocbreak mode).  In half-delay mode, the program waits until a charac-
-       ter is typed or the specified timeout has been reached.
+       (nocbreak  mode).   In  half-delay  mode,  the  program  waits  until a
+       character is typed or the specified timeout has been reached.
 
        If echo is enabled, and the window is not a  pad,  then  the  character
-       will also be echoed into the designated window according to the follow-
-       ing rules:
+       will  also  be  echoed  into  the  designated  window  according to the
+       following rules:
 
        o   If the character is the current erase  character,  left  arrow,  or
            backspace,  the  cursor  is  moved  one  space to the left and that
            screen position is erased as if delch had been called.
 
-       o   If the character value is any other KEY_ define, the user is alert-
-           ed with a beep call.
+       o   If the character value is  any  other  KEY_  define,  the  user  is
+           alerted with a beep call.
 
        o   If  the character is a carriage-return, and if nl is enabled, it is
            translated to a line-feed after echoing.
@@ -104,36 +104,36 @@
        function key is returned instead of the raw characters:
 
        o   The  predefined  function  keys  are listed in <curses.h> as macros
-           with values outside the range of 8-bit characters.  Their names be-
-           gin with KEY_.
+           with values outside the range of  8-bit  characters.   Their  names
+           begin with KEY_.
 
-       o   Other  (user-defined)  function keys which may be defined using de-
-           fine_key(3x) have no names, but also are expected  to  have  values
+       o   Other  (user-defined)  function  keys  which  may  be defined using
+           define_key(3x) have no names, but also are expected to have  values
            outside the range of 8-bit characters.
 
        Thus,  a  variable  intended to hold the return value of a function key
        must be of short size or larger.
 
-       When a character that could be the beginning of a function key  is  re-
-       ceived  (which, on modern terminals, means an escape character), curses
-       sets a timer.  If the remainder of the sequence does not come in within
-       the  designated  time,  the character is passed through; otherwise, the
-       function key value is returned.  For this reason, many terminals  expe-
-       rience  a  delay between the time a user presses the escape key and the
-       escape is returned to the program.
+       When a character that could be the  beginning  of  a  function  key  is
+       received  (which,  on  modern  terminals,  means  an escape character),
+       curses sets a timer.  If the remainder of the sequence does not come in
+       within the designated time, the character is passed through; otherwise,
+       the function key value is returned.  For this  reason,  many  terminals
+       experience  a  delay between the time a user presses the escape key and
+       the escape is returned to the program.
 
        In ncurses, the timer normally expires after the value in ESCDELAY (see
        curs_variables(3x)).   If notimeout is TRUE, the timer does not expire;
        it is an infinite (or very large) value.  Because function keys usually
-       begin  with an escape character, the terminal may appear to hang in no-
-       timeout mode after  pressing  the  escape  key  until  another  key  is
+       begin  with  an  escape  character,  the terminal may appear to hang in
+       notimeout mode after pressing the  escape  key  until  another  key  is
        pressed.

Ungetting characters

        The  ungetch routine places ch back onto the input queue to be returned
-       by the next call to wgetch.  There is just one input queue for all win-
-       dows.
+       by the next call to wgetch.  There is just  one  input  queue  for  all
+       windows.

Predefined key-codes

@@ -142,13 +142,13 @@
        o   Except  for  the special case KEY_RESIZE, it is necessary to enable
            keypad for getch to return these codes.
 
-       o   Not all of these are necessarily supported on any particular termi-
-           nal.
+       o   Not all of  these  are  necessarily  supported  on  any  particular
+           terminal.
 
-       o   The  naming  convention  may  seem obscure, with some apparent mis-
-           spellings (such as "RSUME" for "resume").  The names correspond  to
-           the  long  terminfo capability names for the keys, and were defined
-           long ago, in the 1980s.
+       o   The   naming  convention  may  seem  obscure,  with  some  apparent
+           misspellings (such as "RSUME" for "resume").  The names  correspond
+           to  the  long  terminfo  capability  names  for  the keys, and were
+           defined long ago, in the 1980s.
 
               Name            Key name
               -------------------------------------------------
@@ -263,15 +263,15 @@
            whether or not keypad has been enabled.
 
        o   KEY_MOUSE  is returned for mouse-events (see curs_mouse(3x)).  This
-           code relies upon whether or not keypad(3x) has  been  enabled,  be-
-           cause  (e.g., with xterm(1) mouse prototocol) ncurses must read es-
-           cape sequences, just like a function key.
+           code relies upon  whether  or  not  keypad(3x)  has  been  enabled,
+           because  (e.g.,  with  xterm(1) mouse prototocol) ncurses must read
+           escape sequences, just like a function key.

Testing key-codes

-       The has_key routine takes a key-code value from the above list, and re-
-       turns TRUE or FALSE according to whether the current terminal type rec-
-       ognizes a key with that value.
+       The has_key routine takes a key-code value from  the  above  list,  and
+       returns  TRUE  or  FALSE according to whether the current terminal type
+       recognizes a key with that value.
 
        The library also supports these extensions:
 
@@ -292,8 +292,8 @@
 
           wgetch
                returns ERR if the window pointer is null, or  if  its  timeout
-               expires without having any data, or if the execution was inter-
-               rupted by a signal (errno will be set to EINTR).
+               expires  without  having  any  data,  or  if  the execution was
+               interrupted by a signal (errno will be set to EINTR).
 
        Functions with a "mv" prefix first  perform  a  cursor  movement  using
        wmove, and return an error if the position is outside the window, or if
@@ -305,85 +305,86 @@
        is  discouraged, as it will cause a delay of up to one second while the
        keypad code looks for a following function-key sequence.
 
-       Some keys may be the same as commonly used control keys, e.g.,  KEY_EN-
-       TER  versus control/M, KEY_BACKSPACE versus control/H.  Some curses im-
-       plementations may differ according to whether they treat these  control
-       keys  specially  (and ignore the terminfo), or use the terminfo defini-
-       tions.  Ncurses uses the terminfo definition.  If it says that  KEY_EN-
-       TER is control/M, getch will return KEY_ENTER when you press control/M.
+       Some keys may  be  the  same  as  commonly  used  control  keys,  e.g.,
+       KEY_ENTER  versus  control/M,  KEY_BACKSPACE  versus  control/H.   Some
+       curses implementations may differ according to whether they treat these
+       control  keys  specially (and ignore the terminfo), or use the terminfo
+       definitions.  Ncurses uses the terminfo definition.  If  it  says  that
+       KEY_ENTER  is  control/M,  getch  will  return KEY_ENTER when you press
+       control/M.
 
-       Generally,  KEY_ENTER denotes the character(s) sent by the Enter key on
+       Generally, KEY_ENTER denotes the character(s) sent by the Enter key  on
        the numeric keypad:
 
        o   the terminal description lists the most useful keys,
 
-       o   the Enter key on the regular keyboard is  already  handled  by  the
+       o   the  Enter  key  on  the regular keyboard is already handled by the
            standard ASCII characters for carriage-return and line-feed,
 
        o   depending on whether nl or nonl was called, pressing "Enter" on the
-           regular keyboard may return either a carriage-return or  line-feed,
+           regular  keyboard may return either a carriage-return or line-feed,
            and finally
 
        o   "Enter or send" is the standard description for this key.
 
-       When   using   getch,  wgetch,  mvgetch,  or  mvwgetch,  nocbreak  mode
-       (nocbreak) and echo mode (echo) should not be used at  the  same  time.
-       Depending  on the state of the tty driver when each character is typed,
+       When  using  getch,  wgetch,  mvgetch,  or  mvwgetch,   nocbreak   mode
+       (nocbreak)  and  echo  mode (echo) should not be used at the same time.
+       Depending on the state of the tty driver when each character is  typed,
        the program may produce undesirable results.
 
        Note that getch, mvgetch, and mvwgetch may be macros.
 
-       Historically, the set of keypad macros was largely defined by  the  ex-
-       tremely  function-key-rich  keyboard of the AT&T 7300, aka 3B1, aka Sa-
-       fari 4.  Modern personal computers usually have only a small subset  of
-       these.   IBM  PC-style  consoles  typically  support  little  more than
-       KEY_UP, KEY_DOWN, KEY_LEFT, KEY_RIGHT,  KEY_HOME,  KEY_END,  KEY_NPAGE,
-       KEY_PPAGE,  and  function  keys  1  through 12.  The Ins key is usually
+       Historically,  the  set  of  keypad  macros  was largely defined by the
+       extremely function-key-rich keyboard of the AT&T  7300,  aka  3B1,  aka
+       Safari  4.   Modern personal computers usually have only a small subset
+       of these.  IBM PC-style consoles typically  support  little  more  than
+       KEY_UP,  KEY_DOWN,  KEY_LEFT,  KEY_RIGHT, KEY_HOME, KEY_END, KEY_NPAGE,
+       KEY_PPAGE, and function keys 1 through 12.   The  Ins  key  is  usually
        mapped to KEY_IC.

PORTABILITY

-       The *get* functions are described in the XSI Curses standard, Issue  4.
-       They  read  single-byte  characters  only.  The standard specifies that
+       The  *get* functions are described in the XSI Curses standard, Issue 4.
+       They read single-byte characters only.   The  standard  specifies  that
        they return ERR on failure, but specifies no error conditions.
 
-       The echo behavior of these functions on  input  of  KEY_  or  backspace
-       characters  was not specified in the SVr4 documentation.  This descrip-
-       tion is adopted from the XSI Curses standard.
+       The  echo  behavior  of  these  functions on input of KEY_ or backspace
+       characters  was  not  specified  in  the  SVr4   documentation.    This
+       description is adopted from the XSI Curses standard.
 
        The behavior of getch and friends in the presence of handled signals is
        unspecified in the SVr4 and XSI Curses documentation.  Under historical
-       curses implementations, it varied depending on  whether  the  operating
-       system's  implementation of handled signal receipt interrupts a read(2)
-       call in progress or not, and also (in some  implementations)  depending
+       curses  implementations,  it  varied depending on whether the operating
+       system's implementation of handled signal receipt interrupts a  read(2)
+       call  in  progress or not, and also (in some implementations) depending
        on whether an input timeout or non-blocking mode has been set.
 
        KEY_MOUSE is mentioned in XSI Curses, along with a few related terminfo
-       capabilities, but no higher-level functions use the feature.   The  im-
-       plementation in ncurses is an extension.
+       capabilities,  but  no  higher-level  functions  use  the feature.  The
+       implementation in ncurses is an extension.
 
-       KEY_RESIZE is an extension first implemented for ncurses.  NetBSD curs-
-       es later added this extension.
+       KEY_RESIZE is an  extension  first  implemented  for  ncurses.   NetBSD
+       curses later added this extension.
 
-       Programmers concerned about portability should be prepared  for  either
-       of  two  cases: (a) signal receipt does not interrupt getch; (b) signal
-       receipt interrupts getch and causes it to return ERR with errno set  to
+       Programmers  concerned  about portability should be prepared for either
+       of two cases: (a) signal receipt does not interrupt getch;  (b)  signal
+       receipt  interrupts getch and causes it to return ERR with errno set to
        EINTR.
 
-       The  has_key function is unique to ncurses.  We recommend that any code
+       The has_key function is unique to ncurses.  We recommend that any  code
        using it be conditionalized on the NCURSES_VERSION feature macro.

curs_getstr 3x 2023-08-05 ncurses 6.4 Library calls

curs_getstr 3x 2023-09-16 ncurses 6.4 Library calls

 curs_getstr(3x)                  Library calls                 curs_getstr(3x)
 
@@ -47,8 +47,8 @@

NAME

-       getstr, getnstr, wgetstr, wgetnstr, mvgetstr, mvgetnstr, mvwgetstr,
-       mvwgetnstr - accept character strings from curses terminal keyboard
+       getstr,  getnstr,  wgetstr,  wgetnstr,  mvgetstr, mvgetnstr, mvwgetstr,
+       mvwgetnstr - accept character strings from curses terminal keyboard

SYNOPSIS

@@ -96,28 +96,28 @@
            cursor at the beginning of the buffer.
 
        Characters  input  are  echoed  only  if echo is currently on.  In that
-       case, backspace is echoed as deletion of the previous character  (typi-
-       cally a left motion).
+       case, backspace  is  echoed  as  deletion  of  the  previous  character
+       (typically a left motion).
 
-       The  getnstr, mvgetnstr, mvwgetnstr, and wgetnstr functions are identi-
-       cal to the getstr, mvgetstr, mvwgetstr, and wgetstr functions,  respec-
-       tively, except that the *n* versions read at most n characters, letting
-       the application prevent overflow of the input buffer.
+       The   getnstr,   mvgetnstr,  mvwgetnstr,  and  wgetnstr  functions  are
+       identical to the getstr, mvgetstr, mvwgetstr,  and  wgetstr  functions,
+       respectively,  except  that the *n* versions read at most n characters,
+       letting the application prevent overflow of the input buffer.

NOTES

        Any of these functions other than wgetnstr may be macros.
 
-       Using getstr, mvgetstr, mvwgetstr, or wgetstr to read a line that over-
-       flows the array pointed to by str causes undefined results.  The use of
-       getnstr, mvgetnstr, mvwgetnstr, or wgetnstr,  respectively,  is  recom-
-       mended.
+       Using getstr, mvgetstr, mvwgetstr, or  wgetstr  to  read  a  line  that
+       overflows  the  array  pointed to by str causes undefined results.  The
+       use of getnstr, mvgetnstr, mvwgetnstr, or  wgetnstr,  respectively,  is
+       recommended.

RETURN VALUE

-       All  of  these  functions return the integer OK upon successful comple-
-       tion.  (SVr4 specifies only "an integer value other than ERR")  If  un-
-       successful, they return ERR.
+       All   of   these  functions  return  the  integer  OK  upon  successful
+       completion.  (SVr4 specifies only "an integer value other than ERR") If
+       unsuccessful, they return ERR.
 
        X/Open defines no error conditions.
 
@@ -129,10 +129,11 @@
 
        o   if the associated call to wgetch failed.
 
-       This  implementation  provides an extension as well.  If a SIGWINCH in-
-       terrupts the function, it will return KEY_RESIZE rather than OK or ERR.
+       This  implementation  provides  an  extension  as  well.  If a SIGWINCH
+       interrupts the function, it will return KEY_RESIZE rather  than  OK  or
+       ERR.
 
-       Functions with a "mv" prefix first  perform  a  cursor  movement  using
+       Functions  with  a  "mv"  prefix  first perform a cursor movement using
        wmove, and return an error if the position is outside the window, or if
        the window pointer is null.
 
@@ -141,15 +142,16 @@
        These functions are described in The Single Unix Specification, Version
        2.  No error conditions are defined.
 
-       This  implementation  returns  ERR if the window pointer is null, or if
+       This implementation returns ERR if the window pointer is  null,  or  if
        the lower-level wgetch(3x) call returns an ERR.
 
-       SVr3 and early SVr4 curses  implementations  did  not  reject  function
-       keys;  the  SVr4.0  documentation  claimed that "special keys" (such as
-       function keys, "home" key, "clear" key, etc.) are "interpreted",  with-
-       out  giving details.  It lied.  In fact, the "character" value appended
-       to the string by those implementations was predictable but  not  useful
-       (being, in fact, the low-order eight bits of the key's KEY_ value).
+       SVr3  and  early  SVr4  curses  implementations did not reject function
+       keys; the SVr4.0 documentation claimed that  "special  keys"  (such  as
+       function  keys,  "home"  key,  "clear"  key,  etc.)  are "interpreted",
+       without giving details.  It  lied.   In  fact,  the  "character"  value
+       appended to the string by those implementations was predictable but not
+       useful (being, in fact, the low-order eight  bits  of  the  key's  KEY_
+       value).
 
        The  functions  getnstr, mvgetnstr, and mvwgetnstr were present but not
        documented in SVr4.
@@ -165,71 +167,72 @@
 
        o   Solaris SVr4 and NetBSD curses count the NUL as part of the limit.
 
-       o   Solaris  xcurses  provides  both:  its wide-character wget_nstr re-
-           serves a NUL, but its wgetnstr does not count the NUL consistently.
+       o   Solaris   xcurses   provides  both:  its  wide-character  wget_nstr
+           reserves  a  NUL,  but  its  wgetnstr  does  not  count   the   NUL
+           consistently.
 
        In SVr4 curses, a negative value of n tells wgetnstr to assume that the
-       caller's  buffer  is large enough to hold the result, i.e., to act like
-       wgetstr.  X/Open Curses does not mention this (or anything  related  to
-       negative  or  zero  values  of n), however most implementations use the
+       caller's buffer is large enough to hold the result, i.e., to  act  like
+       wgetstr.   X/Open  Curses does not mention this (or anything related to
+       negative or zero values of n), however  most  implementations  use  the
        feature, with different limits:
 
-       o   Solaris SVr4 curses and PDCurses limit the  result  to  255  bytes.
+       o   Solaris  SVr4  curses  and  PDCurses limit the result to 255 bytes.
            Other Unix systems than Solaris are likely to use the same limit.
 
        o   Solaris xcurses limits the result to LINE_MAX bytes.
 
-       o   NetBSD  7  assumes no particular limit for the result from wgetstr.
-           However, it limits the wgetnstr parameter n to ensure  that  it  is
+       o   NetBSD 7 assumes no particular limit for the result  from  wgetstr.
+           However,  it  limits  the wgetnstr parameter n to ensure that it is
            greater than zero.
 
-           A  comment in NetBSD's source code states that this is specified in
+           A comment in NetBSD's source code states that this is specified  in
            SUSv2.
 
-       o   ncurses (before 6.2) assumes no particular  limit  for  the  result
-           from  wgetstr,  and  treats  the  n parameter of wgetnstr like SVr4
+       o   ncurses  (before  6.2)  assumes  no particular limit for the result
+           from wgetstr, and treats the n  parameter  of  wgetnstr  like  SVr4
            curses.
 
-       o   ncurses 6.2 uses LINE_MAX, or  a  larger  (system-dependent)  value
-           which  the  sysconf  function  may provide.  If neither LINE_MAX or
-           sysconf is available, ncurses uses the POSIX value for LINE_MAX  (a
-           2048  byte limit).  In either case, it reserves a byte for the ter-
-           minating NUL.
+       o   ncurses  6.2  uses  LINE_MAX,  or a larger (system-dependent) value
+           which the sysconf function may provide.   If  neither  LINE_MAX  or
+           sysconf  is available, ncurses uses the POSIX value for LINE_MAX (a
+           2048 byte limit).  In either case,  it  reserves  a  byte  for  the
+           terminating NUL.
 
-       Although getnstr is equivalent to a series of calls to getch,  it  also
-       makes  changes to the curses modes to allow simple editing of the input
+       Although  getnstr  is equivalent to a series of calls to getch, it also
+       makes changes to the curses modes to allow simple editing of the  input
        buffer:
 
-       o   getnstr saves the current value of the nl,  echo,  raw  and  cbreak
+       o   getnstr  saves  the  current  value of the nl, echo, raw and cbreak
            modes, and sets nl, noecho, noraw, and cbreak.
 
-           getnstr  handles  the echoing of characters, rather than relying on
+           getnstr handles the echoing of characters, rather than  relying  on
            the caller to set an appropriate mode.
 
-       o   It also obtains the erase and kill characters  from  erasechar  and
+       o   It  also  obtains  the erase and kill characters from erasechar and
            killchar, respectively.
 
        o   On return, getnstr restores the modes to their previous values.
 
        Other implementations differ in their treatment of special characters:
 
-       o   While they may set the echo mode, other implementations do not mod-
-           ify the raw mode, They may take the cbreak mode set by  the  caller
-           into account when deciding whether to handle echoing within getnstr
-           or as a side-effect of the getch calls.
+       o   While they may set the echo  mode,  other  implementations  do  not
+           modify  the  raw  mode,  They  may  take the cbreak mode set by the
+           caller into account when deciding whether to handle echoing  within
+           getnstr or as a side-effect of the getch calls.
 
        o   The original ncurses (as pcurses in 1986) set noraw and cbreak when
-           accepting input for getnstr.  That may have been done to make func-
-           tion- and cursor-keys work; it is not necessary with ncurses.
+           accepting input for getnstr.  That  may  have  been  done  to  make
+           function- and cursor-keys work; it is not necessary with ncurses.
 
-           Since 1995, ncurses has provided signal handlers for INTR and  QUIT
-           (e.g.,  ^C  or  ^\).  With the noraw and cbreak settings, those may
-           catch a signal and stop the program,  where  other  implementations
+           Since  1995, ncurses has provided signal handlers for INTR and QUIT
+           (e.g., ^C or ^\).  With the noraw and cbreak  settings,  those  may
+           catch  a  signal  and stop the program, where other implementations
            allow one to enter those characters in the buffer.
 
        o   Starting in 2021 (ncurses 6.3), getnstr sets raw, rather than noraw
-           and cbreak for better compatibility with SVr4-curses, e.g.,  allow-
-           ing one to enter a ^C into the buffer.
+           and   cbreak  for  better  compatibility  with  SVr4-curses,  e.g.,
+           allowing one to enter a ^C into the buffer.

curs_getyx 3x 2023-07-01 ncurses 6.4 Library calls

curs_getyx 3x 2023-09-16 ncurses 6.4 Library calls

 curs_getyx(3x)                   Library calls                  curs_getyx(3x)
 
@@ -47,7 +47,7 @@

NAME

-       getyx,  getparyx,  getbegyx,  getmaxyx  -  get curses cursor and window
+       getyx,  getparyx,  getbegyx,  getmaxyx  -  get curses cursor and window
        coordinates
 
 
@@ -109,7 +109,7 @@
 
 
 
-ncurses 6.4                       2023-07-01                    curs_getyx(3x)
+ncurses 6.4                       2023-09-16                    curs_getyx(3x)

curs_in_wch 3x 2022-02-12 ncurses 6.4 Library calls

curs_in_wch 3x 2023-09-16 ncurses 6.4 Library calls

curs_in_wch 3x 2022-02-12 ncurses 6.4 Library calls

curs_in_wch 3x 2023-09-16 ncurses 6.4 Library calls

 curs_in_wch(3x)                  Library calls                 curs_in_wch(3x)
 
@@ -47,8 +47,8 @@

NAME

-       in_wch,  mvin_wch, mvwin_wch, win_wch - extract a complex character and
-       rendition from a window
+       in_wch,  mvin_wch,  mvwin_wch, win_wch - get a curses complex character
+       from a window

SYNOPSIS

@@ -91,7 +91,7 @@
 
 
 
-ncurses 6.4                       2022-02-12                   curs_in_wch(3x)
+ncurses 6.4                       2023-09-16                   curs_in_wch(3x)

curs_in_wchstr 3x 2022-02-12 ncurses 6.4 Library calls

curs_in_wchstr 3x 2023-09-16 ncurses 6.4 Library calls

curs_in_wchstr 3x 2022-02-12 ncurses 6.4 Library calls

curs_in_wchstr 3x 2023-09-16 ncurses 6.4 Library calls

 curs_in_wchstr(3x)               Library calls              curs_in_wchstr(3x)
 
@@ -47,9 +47,9 @@

NAME

-       in_wchstr, in_wchnstr, win_wchstr, win_wchnstr, mvin_wchstr,
-       mvin_wchnstr, mvwin_wchstr, mvwin_wchnstr - get an array of complex
-       characters and renditions from a curses window
+       in_wchstr,    in_wchnstr,    win_wchstr,    win_wchnstr,   mvin_wchstr,
+       mvin_wchnstr,  mvwin_wchstr,  mvwin_wchnstr  -  get  a  curses  complex
+       character string from a window

SYNOPSIS

@@ -67,9 +67,9 @@

DESCRIPTION

-       These functions return an array of complex characters in wchstr, start-
-       ing at the current cursor position in  the  named  window.   Attributes
-       (rendition) are stored with the characters.
+       These  functions  return  an  array  of  complex  characters in wchstr,
+       starting  at  the  current  cursor  position  in  the   named   window.
+       Attributes (rendition) are stored with the characters.
 
        The  in_wchnstr,  mvin_wchnstr,  mvwin_wchnstr and win_wchnstr fill the
        array with at most n cchar_t elements.
@@ -79,9 +79,9 @@
        Note that all routines except win_wchnstr may be macros.
 
        Reading a line that overflows the  array  pointed  to  by  wchstr  with
-       in_wchstr, mvin_wchstr, mvwin_wchstr or win_wchstr causes undefined re-
-       sults.  Therefore, the use of in_wchnstr, mvin_wchnstr,  mvwin_wchnstr,
-       or win_wchnstr is recommended.
+       in_wchstr,  mvin_wchstr,  mvwin_wchstr  or  win_wchstr causes undefined
+       results.    Therefore,   the   use   of    in_wchnstr,    mvin_wchnstr,
+       mvwin_wchnstr, or win_wchnstr is recommended.

RETURN VALUE

@@ -104,7 +104,7 @@
 
 
 
-ncurses 6.4                       2022-02-12                curs_in_wchstr(3x)
+ncurses 6.4                       2023-09-16                curs_in_wchstr(3x)

curs_inch 3x 2023-08-19 ncurses 6.4 Library calls

curs_inch 3x 2023-09-16 ncurses 6.4 Library calls

curs_inch 3x 2023-08-19 ncurses 6.4 Library calls

curs_inch 3x 2023-09-16 ncurses 6.4 Library calls

 curs_inch(3x)                    Library calls                   curs_inch(3x)
 
@@ -48,8 +48,7 @@

NAME

-       inch,  winch,  mvinch,  mvwinch - get a character and attributes from a
-       curses window
+       inch, winch, mvinch, mvwinch - get a curses character from a window

SYNOPSIS

@@ -63,15 +62,15 @@

DESCRIPTION

-       These routines return the character, of type  chtype,  at  the  current
-       position  in  the  named  window.   If  any attributes are set for that
-       position, their values are OR'ed into the  value  returned.   Constants
-       defined  in <curses.h> can be used with the & (logical AND) operator to
+       These  routines  return  the  character, of type chtype, at the current
+       position in the named window.  If  any  attributes  are  set  for  that
+       position,  their  values  are OR'ed into the value returned.  Constants
+       defined in <curses.h> can be used with the & (logical AND) operator  to
        extract the character or attributes alone.

Attributes

-       The following bit-masks may  be  AND-ed  with  characters  returned  by
+       The  following  bit-masks  may  be  AND-ed  with characters returned by
        winch.
 
        A_CHARTEXT     Bit-mask to extract character
@@ -80,12 +79,12 @@

RETURN VALUE

-       Functions  with  a  "mv"  prefix  first perform a cursor movement using
+       Functions with a "mv" prefix first  perform  a  cursor  movement  using
        wmove, and return an error if the position is outside the window, or if
        the window pointer is null.
 
-       The  winch  function  does  not  return an error if the window contains
-       characters larger than 8-bits (255).  Only the low-order 8 bits of  the
+       The winch function does not return an  error  if  the  window  contains
+       characters  larger than 8-bits (255).  Only the low-order 8 bits of the
        character are used by winch.
 
 
@@ -96,26 +95,26 @@

PORTABILITY

        These functions are described in the XSI Curses standard, Issue 4.
 
-       Very  old systems (before standardization) provide a different function
+       Very old systems (before standardization) provide a different  function
        with the same name:
 
-       o   The winch function was part of the  original  BSD  curses  library,
-           which   stored   a  7-bit  character  combined  with  the  standout
+       o   The  winch  function  was  part of the original BSD curses library,
+           which  stored  a  7-bit  character  combined  with   the   standout
            attribute.
 
-           In BSD curses, winch returned only the character  (as  an  integer)
+           In  BSD  curses,  winch returned only the character (as an integer)
            with the standout attribute removed.
 
-       o   System  V  curses  added support for several video attributes which
+       o   System V curses added support for several  video  attributes  which
            could be combined with characters in the window.
 
            Reflecting this improvement, the function was altered to return the
            character combined with all video attributes in a chtype value.
 
        X/Open Curses does not specify the size and layout of attributes, color
-       and character values in chtype; it is  implementation-dependent.   This
-       implementation  uses 8 bits for character values.  An application using
-       more bits,  e.g.,  a  Unicode  value,  should  use  the  wide-character
+       and  character  values in chtype; it is implementation-dependent.  This
+       implementation uses 8 bits for character values.  An application  using
+       more  bits,  e.g.,  a  Unicode  value,  should  use  the wide-character
        equivalents to these functions.
 
 
@@ -124,16 +123,16 @@
             gives an overview of the WINDOW and chtype data types.
 
        curs_attr(3x)
-            goes  into  more  detail,  pointing  out  portability problems and
+            goes into more  detail,  pointing  out  portability  problems  and
             constraints on the use of chtype for returning window information.
 
        curs_in_wch(3x)
-            describes comparable functions for the  wide-character  (ncursesw)
+            describes  comparable  functions for the wide-character (ncursesw)
             library.
 
 
 
-ncurses 6.4                       2023-08-19                     curs_inch(3x)
+ncurses 6.4                       2023-09-16                     curs_inch(3x)

curs_inchstr 3x 2023-07-01 ncurses 6.4 Library calls

curs_inchstr 3x 2023-09-16 ncurses 6.4 Library calls

curs_inchstr 3x 2023-07-01 ncurses 6.4 Library calls

curs_inchstr 3x 2023-09-16 ncurses 6.4 Library calls

 curs_inchstr(3x)                 Library calls                curs_inchstr(3x)
 
@@ -47,9 +47,8 @@

NAME

-       inchstr, inchnstr, winchstr, winchnstr, mvinchstr, mvinchnstr,
-       mvwinchstr, mvwinchnstr - get a string of characters (and attributes)
-       from a curses window
+       inchstr,   inchnstr,   winchstr,   winchnstr,   mvinchstr,  mvinchnstr,
+       mvwinchstr, mvwinchnstr - get a curses character string from a window

SYNOPSIS

@@ -67,20 +66,20 @@

DESCRIPTION

-       These  routines  return  a  NULL-terminated array of chtype quantities,
-       starting at the current cursor position in the named window and  ending
-       at  the  right  margin of the window.  The four functions with n as the
-       last argument, return a leading substring at  most  n  characters  long
+       These routines return a NULL-terminated  array  of  chtype  quantities,
+       starting  at the current cursor position in the named window and ending
+       at the right margin of the window.  The four functions with  n  as  the
+       last  argument,  return  a  leading substring at most n characters long
        (exclusive of the trailing (chtype)0).  Constants defined in <curses.h>
-       can be used with the & (logical AND) operator to extract the  character
-       or   the   attribute   alone  from  any  position  in  the  chstr  [see
+       can  be used with the & (logical AND) operator to extract the character
+       or  the  attribute  alone  from  any  position  in   the   chstr   [see
        curs_inch(3x)].

RETURN VALUE

-       All routines return the integer ERR upon failure and an  integer  value
-       other than ERR upon successful completion (the number of characters re-
-       trieved, exclusive of the trailing 0).
+       All  routines  return the integer ERR upon failure and an integer value
+       other than ERR upon successful completion  (the  number  of  characters
+       retrieved, exclusive of the trailing 0).
 
        X/Open Curses defines no error conditions.  In this implementation:
 
@@ -88,33 +87,33 @@
 
        o   If the chstr parameter is null, an error is returned,
 
-       Functions with a "mv" prefix first  perform  a  cursor  movement  using
+       Functions  with  a  "mv"  prefix  first perform a cursor movement using
        wmove, and return an error if the position is outside the window, or if
        the window pointer is null.

NOTES

-       Note that all routines except winchnstr may be macros.  SVr4  does  not
-       document whether the result string is zero-terminated; it does not doc-
-       ument whether a length limit argument includes any trailing 0;  and  it
-       does not document the meaning of the return value.
+       Note  that  all routines except winchnstr may be macros.  SVr4 does not
+       document whether the result string  is  zero-terminated;  it  does  not
+       document  whether  a length limit argument includes any trailing 0; and
+       it does not document the meaning of the return value.

PORTABILITY

-       These  functions are described in the XSI Curses standard, Issue 4.  It
-       is no more specific than the SVr4 documentation on the trailing 0.   It
+       These functions are described in the XSI Curses standard, Issue 4.   It
+       is  no more specific than the SVr4 documentation on the trailing 0.  It
        does specify that the successful return of the functions is OK.

curs_initscr 3x 2023-08-19 ncurses 6.4 Library calls

curs_initscr 3x 2023-09-16 ncurses 6.4 Library calls

 curs_initscr(3x)                 Library calls                curs_initscr(3x)
 
@@ -47,8 +47,8 @@

NAME

-       initscr, newterm, endwin, isendwin, set_term, delscreen - curses screen
-       initialization and manipulation routines
+       initscr,  newterm,  endwin, isendwin, set_term, delscreen - initialize,
+       manipulate, or tear down curses terminal interface

SYNOPSIS

@@ -72,11 +72,11 @@
        it; these are slk_init(3x), filter, ripoffline, use_env.  For multiple-
        terminal applications, newterm may be called before initscr.
 
-       The initscr code determines the terminal type and initializes all curs-
-       es data structures.  initscr also causes the first call to  refresh(3x)
-       to  clear  the  screen.  If errors occur, initscr writes an appropriate
-       error message to standard error and exits; otherwise, a pointer is  re-
-       turned to stdscr.
+       The  initscr  code  determines  the  terminal  type and initializes all
+       curses  data  structures.   initscr  also  causes  the  first  call  to
+       refresh(3x)  to  clear  the screen.  If errors occur, initscr writes an
+       appropriate error message to standard error  and  exits;  otherwise,  a
+       pointer is returned to stdscr.

newterm

@@ -86,9 +86,9 @@
        if the terminal cannot support a screen-oriented  program,  would  also
        use newterm.
 
-       The  routine  newterm  should be called once for each terminal.  It re-
-       turns a variable of type SCREEN * which should be saved as a  reference
-       to that terminal.  newterm's arguments are
+       The  routine  newterm  should  be  called  once  for each terminal.  It
+       returns a variable of  type  SCREEN  *  which  should  be  saved  as  a
+       reference to that terminal.  newterm's arguments are
 
        o   the type of the terminal to be used in place of $TERM,
 
@@ -99,8 +99,8 @@
        If the type parameter is NULL, $TERM will be used.
 
        The  file  descriptor  of the output stream is passed to setupterm(3x),
-       which returns a pointer to a TERMINAL structure.  newterm's return val-
-       ue holds a pointer to the TERMINAL structure.
+       which returns a pointer to  a  TERMINAL  structure.   newterm's  return
+       value holds a pointer to the TERMINAL structure.

endwin

@@ -116,13 +116,13 @@
 
        o   moves the cursor to the lower left-hand corner of the screen,
 
-       o   clears  the  remainder of the line so that it uses the default col-
-           ors,
+       o   clears  the  remainder  of  the  line  so  that it uses the default
+           colors,
 
        o   sets the cursor to normal visibility (see curs_set(3x)),
 
-       o   stops cursor-addressing mode using the exit_ca_mode terminal  capa-
-           bility,
+       o   stops  cursor-addressing  mode  using  the  exit_ca_mode   terminal
+           capability,
 
        o   restores tty modes (see reset_shell_mode(3x)).
 
@@ -137,8 +137,8 @@

set_term

        The  set_term  routine  is  used to switch between different terminals.
-       The screen reference new becomes the new current terminal.  The  previ-
-       ous  terminal  is  returned  by  the routine.  This is the only routine
+       The screen  reference  new  becomes  the  new  current  terminal.   The
+       previous terminal is returned by the routine.  This is the only routine
        which manipulates SCREEN pointers; all other routines affect  only  the
        current terminal.
 
@@ -150,8 +150,8 @@

RETURN VALUE

-       endwin returns the integer ERR upon failure and OK upon successful com-
-       pletion.
+       endwin  returns  the  integer  ERR  upon failure and OK upon successful
+       completion.
 
        Routines that return pointers always return NULL on error.
 
@@ -188,9 +188,9 @@
        newterm.  Deleting a SCREEN provides a way to do this:
 
        o   X/Open Curses does not say what happens to WINDOWs  when  delscreen
-           "frees  storage associated with the SCREEN" nor does the SVr4 docu-
-           mentation help, adding that it should be called after endwin  if  a
-           SCREEN is no longer needed.
+           "frees  storage  associated  with  the  SCREEN"  nor  does the SVr4
+           documentation help, adding that it should be called after endwin if
+           a SCREEN is no longer needed.
 
        o   However,  WINDOWs are implicitly associated with a SCREEN.  so that
            it is reasonable to expect delscreen to deal with these.
@@ -199,9 +199,9 @@
            curscr  as  well  as a work area newscr.  SVr4 curses ignores other
            windows.
 
-       o   Since version 4.0 (1996), ncurses has maintained a list of all win-
-           dows  for  each screen, using that information to delete those win-
-           dows when delscreen is called.
+       o   Since version 4.0 (1996), ncurses has  maintained  a  list  of  all
+           windows  for  each  screen,  using that information to delete those
+           windows when delscreen is called.
 
        o   NetBSD copied this feature of ncurses in  2001.   PDCurses  follows
            the SVr4 model, deleting only the standard WINDOW structures.
@@ -209,12 +209,12 @@

High-level versus low-level

        Different  implementations  may  disagree  regarding  the level of some
-       functions.  For example, SCREEN (returned by newterm) and TERMINAL (re-
-       turned  by  setupterm(3x)) hold file descriptors for the output stream.
-       If an application switches screens using set_term, or  switches  termi-
-       nals  using set_curterm(3x), applications which use the output file de-
-       scriptor can have different behavior depending on which structure holds
-       the corresponding descriptor.
+       functions.  For example, SCREEN  (returned  by  newterm)  and  TERMINAL
+       (returned  by  setupterm(3x))  hold  file  descriptors  for  the output
+       stream.  If an application switches screens using set_term, or switches
+       terminals using set_curterm(3x), applications which use the output file
+       descriptor can have different behavior  depending  on  which  structure
+       holds the corresponding descriptor.
 
        For example
 
@@ -227,31 +227,31 @@

Unset TERM Variable

-       If the TERM variable is missing or empty, initscr uses the  value  "un-
-       known", which normally corresponds to a terminal entry with the generic
-       (gn) capability.  Generic entries are  detected  by  setupterm(3x)  and
-       cannot  be  used  for full-screen operation.  Other implementations may
-       handle a missing/empty TERM variable differently.
+       If the TERM variable is  missing  or  empty,  initscr  uses  the  value
+       "unknown",  which  normally  corresponds  to  a terminal entry with the
+       generic (gn) capability.  Generic entries are detected by setupterm(3x)
+       and  cannot  be  used for full-screen operation.  Other implementations
+       may handle a missing/empty TERM variable differently.

Signal Handlers

-       Quoting from X/Open Curses, section 3.1.1:
+       Quoting from X/Open Curses Issue 7, section 3.1.1:
 
-            Curses implementations may provide for  special  handling  of  the
-            SIGINT,  SIGQUIT  and  SIGTSTP  signals  if  their  disposition is
-            SIG_DFL at the time initscr is called ...
+            Curses implementations may provide for  special  handling  of  the
+            SIGINT,  SIGQUIT,  and  SIGTSTP  signals  if  their disposition is
+            SIG_DFL at the time initscr is called...
 
-            Any special handling for these signals may remain  in  effect  for
-            the  life  of  the  process  or  until  the  process  changes  the
-            disposition of the signal.
+            Any special handling for these signals may remain  in  effect  for
+            the  life  of  the  process  or  until  the  process  changes  the
+            disposition of the signal.
 
-            None of the Curses functions are required to be safe with  respect
-            to signals ...
+            None of the Curses functions are required to be safe with  respect
+            to signals...
 
        This  implementation establishes signal handlers during initialization,
        e.g., initscr or newterm.  Applications which must handle these signals
-       should  set  up  the  corresponding handlers after initializing the li-
-       brary:
+       should  set  up  the  corresponding  handlers  after  initializing  the
+       library:
 
        SIGINT
             The handler attempts to cleanup the screen on exit.   Although  it
@@ -260,8 +260,8 @@
             o   Walking  the  SCREEN list is unsafe, since all list management
                 is done without any signal blocking.
 
-            o   On systems which have REENTRANT turned on, set_term uses func-
-                tions which could deadlock or misbehave in other ways.
+            o   On systems which  have  REENTRANT  turned  on,  set_term  uses
+                functions which could deadlock or misbehave in other ways.
 
             o   endwin calls other functions, many of which use stdio or other
                 library functions which are clearly unsafe.
@@ -280,21 +280,21 @@
 
        SIGWINCH
             This handles the window-size changes which  were  ignored  in  the
-            standardization  efforts.   The handler sets a (signal-safe) vari-
-            able which is later tested in  wgetch  (see  curs_getch(3x)).   If
-            keypad  has  been enabled for the corresponding window, wgetch re-
-            turns the key symbol KEY_RESIZE.  At the same time,  wgetch  calls
+            standardization   efforts.    The  handler  sets  a  (signal-safe)
+            variable which is later tested in wgetch (see curs_getch(3x)).  If
+            keypad  has  been  enabled  for  the  corresponding window, wgetch
+            returns the key symbol KEY_RESIZE.  At the same time, wgetch calls
             resizeterm  to adjust the standard screen stdscr, and update other
             data such as LINES and COLS.

curs_inopts 3x 2023-08-19 ncurses 6.4 Library calls

curs_inopts 3x 2023-09-16 ncurses 6.4 Library calls

 curs_inopts(3x)                  Library calls                 curs_inopts(3x)
 
@@ -48,10 +48,10 @@

NAME

-       cbreak, echo, halfdelay, intrflush, is_cbreak, is_echo, is_nl, is_raw,
-       keypad, meta, nl, nocbreak, nodelay, noecho, nonl, noqiflush, noraw,
-       notimeout, qiflush, raw, timeout, wtimeout, typeahead - curses input
-       options
+       cbreak,  echo, halfdelay, intrflush, is_cbreak, is_echo, is_nl, is_raw,
+       keypad, meta, nl, nocbreak, nodelay, noecho,  nonl,  noqiflush,  noraw,
+       notimeout,  qiflush,  raw,  timeout,  wtimeout, typeahead - get and set
+       curses terminal input options

SYNOPSIS

@@ -94,45 +94,45 @@

DESCRIPTION

        The ncurses library provides several functions which let an application
        change  the  way  input from the terminal is handled.  Some are global,
-       applying to all windows.  Others apply only to a specific window.  Win-
-       dow-specific  settings  are not automatically applied to new or derived
-       windows.  An application must apply these to each window, if  the  same
-       behavior is needed.
+       applying to all windows.  Others  apply  only  to  a  specific  window.
+       Window-specific  settings  are  not  automatically  applied  to  new or
+       derived windows.  An application must apply these to  each  window,  if
+       the same behavior is needed.

cbreak/nocbreak

        Normally,  the  tty  driver buffers typed characters until a newline or
        carriage return is typed.  The cbreak routine disables  line  buffering
-       and erase/kill character-processing (interrupt and flow control charac-
-       ters are unaffected), making characters typed by the  user  immediately
-       available to the program.  The nocbreak routine returns the terminal to
-       normal (cooked) mode.
+       and   erase/kill   character-processing  (interrupt  and  flow  control
+       characters  are  unaffected),  making  characters  typed  by  the  user
+       immediately available to the program.  The nocbreak routine returns the
+       terminal to normal (cooked) mode.
 
        Initially the terminal may or may not be in cbreak mode, as the mode is
-       inherited;  therefore, a program should call cbreak or nocbreak explic-
-       itly.  Most interactive programs using  curses  set  the  cbreak  mode.
-       Note  that  cbreak overrides raw.  [See curs_getch(3x) for a discussion
-       of how these routines interact with echo and noecho.]
+       inherited;   therefore,  a  program  should  call  cbreak  or  nocbreak
+       explicitly.  Most interactive programs  using  curses  set  the  cbreak
+       mode.   Note  that  cbreak  overrides  raw.   [See curs_getch(3x) for a
+       discussion of how these routines interact with echo and noecho.]

echo/noecho

        The echo and noecho routines control whether characters  typed  by  the
        user  are  echoed  by  getch(3x) as they are typed.  Echoing by the tty
        driver is always disabled, but initially getch  is  in  echo  mode,  so
-       characters typed are echoed.  Authors of most interactive programs pre-
-       fer to do their own echoing in a controlled area of the screen, or  not
-       to  echo  at  all,  so  they  disable  echoing by calling noecho.  [See
+       characters  typed  are  echoed.   Authors  of most interactive programs
+       prefer to do their own echoing in a controlled area of the  screen,  or
+       not  to  echo  at all, so they disable echoing by calling noecho.  [See
        curs_getch(3x) for a discussion of how  these  routines  interact  with
        cbreak and nocbreak.]

halfdelay

        The  halfdelay routine is used for half-delay mode, which is similar to
-       cbreak mode in that characters typed by the user are immediately avail-
-       able to the program.  However, after blocking for tenths tenths of sec-
-       onds, ERR is returned if nothing has been typed.  The value  of  tenths
-       must  be  a number between 1 and 255.  Use nocbreak to leave half-delay
-       mode.
+       cbreak mode in that  characters  typed  by  the  user  are  immediately
+       available to the program.  However, after blocking for tenths tenths of
+       seconds, ERR is returned if nothing  has  been  typed.   The  value  of
+       tenths must be a number between 1 and 255.  Use nocbreak to leave half-
+       delay mode.

intrflush

@@ -146,28 +146,28 @@

keypad

-       The keypad option enables the keypad of the user's  terminal.   If  en-
-       abled (bf is TRUE), the user can press a function key (such as an arrow
-       key) and wgetch(3x) returns a single value  representing  the  function
-       key,  as in KEY_LEFT.  If disabled (bf is FALSE), curses does not treat
-       function keys specially and the program has to interpret the escape se-
-       quences  itself.   If the keypad in the terminal can be turned on (made
-       to transmit) and off (made to work locally),  turning  on  this  option
-       causes  the  terminal keypad to be turned on when wgetch(3x) is called.
-       The default value for keypad is FALSE.
+       The keypad option enables  the  keypad  of  the  user's  terminal.   If
+       enabled  (bf  is  TRUE),  the user can press a function key (such as an
+       arrow key) and wgetch(3x)  returns  a  single  value  representing  the
+       function  key,  as in KEY_LEFT.  If disabled (bf is FALSE), curses does
+       not treat function keys specially and the program has to interpret  the
+       escape  sequences  itself.  If the keypad in the terminal can be turned
+       on (made to transmit) and off (made to work locally), turning  on  this
+       option  causes  the  terminal keypad to be turned on when wgetch(3x) is
+       called.  The default value for keypad is FALSE.

nl/nonl

@@ -191,12 +191,12 @@

raw/noraw

        The raw and noraw routines place the terminal into or out of raw  mode.
-       Raw  mode is similar to cbreak mode, in that characters typed are imme-
-       diately passed through to the user program.  The differences  are  that
-       in  raw mode, the interrupt, quit, suspend, and flow control characters
-       are all passed through uninterpreted, instead of generating  a  signal.
-       The  behavior  of the BREAK key depends on other bits in the tty driver
-       that are not set by curses.
+       Raw  mode  is  similar  to  cbreak  mode,  in that characters typed are
+       immediately passed through to the user program.   The  differences  are
+       that  in  raw  mode,  the  interrupt,  quit,  suspend, and flow control
+       characters are all passed through uninterpreted, instead of  generating
+       a  signal.   The behavior of the BREAK key depends on other bits in the
+       tty driver that are not set by curses.

qiflush/noqiflush

@@ -220,27 +220,27 @@

typeahead

-       The curses library does "line-breakout optimization" by looking for ty-
-       peahead periodically while updating the screen.  If input is found, and
-       it is coming from a tty, the current  update  is  postponed  until  re-
-       fresh(3x)  or doupdate is called again.  This allows faster response to
-       commands typed in advance.  Normally, the input FILE pointer passed  to
-       newterm, or stdin in the case that initscr was used, will be used to do
-       this typeahead checking.  The typeahead routine specifies that the file
-       descriptor  fd  is to be used to check for typeahead instead.  If fd is
-       -1, then no typeahead checking is done.
+       The curses library does "line-breakout  optimization"  by  looking  for
+       typeahead  periodically  while updating the screen.  If input is found,
+       and it is coming from a tty, the  current  update  is  postponed  until
+       refresh(3x)  or  doupdate is called again.  This allows faster response
+       to commands typed in advance.  Normally, the input FILE pointer  passed
+       to newterm, or stdin in the case that initscr was used, will be used to
+       do this typeahead checking.  The typeahead routine specifies  that  the
+       file descriptor fd is to be used to check for typeahead instead.  If fd
+       is -1, then no typeahead checking is done.

RETURN VALUE

        All routines that return an integer return  ERR  upon  failure  and  OK
        (SVr4 specifies only "an integer value other than ERR") upon successful
-       completion, unless otherwise noted in the  preceding  routine  descrip-
-       tions.
+       completion,  unless  otherwise   noted   in   the   preceding   routine
+       descriptions.
 
        X/Open  does  not define any error conditions.  In this implementation,
        functions with a window parameter will return an error if it  is  null.
-       Any function will also return an error if the terminal was not initial-
-       ized.  Also,
+       Any  function  will  also  return  an  error  if  the  terminal was not
+       initialized.  Also,
 
           halfdelay
                returns an error if its parameter is outside the range 1..255.
@@ -267,21 +267,21 @@
 
        These  routines  are  specific  to ncurses.  They were not supported on
        Version 7, BSD or System V implementations.  It is recommended that any
-       code  depending on ncurses extensions be conditioned using NCURSES_VER-
-       SION.
+       code   depending   on   ncurses   extensions   be   conditioned   using
+       NCURSES_VERSION.

PORTABILITY

-       Except as noted in the section on extensions, these functions  are  de-
-       scribed in the XSI Curses standard, Issue 4.
+       Except as noted in the  section  on  extensions,  these  functions  are
+       described in the XSI Curses standard, Issue 4.
 
        The ncurses library obeys the XPG4 standard and the historical practice
        of the AT&T curses implementations, in that the  echo  bit  is  cleared
        when  curses  initializes the terminal state.  BSD curses differed from
        this slightly; it left the echo bit on at initialization, but  the  BSD
        raw  call  turned  it  off as a side-effect.  For best portability, set
-       echo or noecho explicitly just after initialization, even if your  pro-
-       gram remains in cooked mode.
+       echo or noecho explicitly  just  after  initialization,  even  if  your
+       program remains in cooked mode.
 
        The  XSI  Curses  standard  is ambiguous on the question of whether raw
        should disable the CRLF translations controlled by nl  and  nonl.   BSD
@@ -291,51 +291,52 @@
        that the operating system will not alter.
 
        When keypad is first enabled, ncurses loads the key-definitions for the
-       current terminal description.  If the terminal description includes ex-
-       tended string capabilities, e.g., from using the -x option of tic, then
-       ncurses  also  defines keys for the capabilities whose names begin with
-       "k".  The corresponding keycodes are generated and (depending on previ-
-       ous  loads of terminal descriptions) may differ from one execution of a
-       program to the next.  The generated keycodes are recognized by the key-
-       name  function (which will then return a name beginning with "k" denot-
-       ing the terminfo capability name rather than "K", used for curses  key-
-       names).  On the other hand, an application can use define_key to estab-
-       lish a specific keycode for a given string.  This makes it possible for
-       an  application  to  check  for  an extended capability's presence with
-       tigetstr, and reassign the keycode to match its own needs.
+       current  terminal  description.   If  the terminal description includes
+       extended string capabilities, e.g., from using the -x  option  of  tic,
+       then  ncurses  also defines keys for the capabilities whose names begin
+       with "k".  The corresponding keycodes are generated and  (depending  on
+       previous  loads of terminal descriptions) may differ from one execution
+       of a program to the next.  The generated keycodes are recognized by the
+       keyname  function  (which  will  then  return a name beginning with "k"
+       denoting the terminfo capability name rather than "K", used for  curses
+       key-names).   On  the  other hand, an application can use define_key to
+       establish a specific  keycode  for  a  given  string.   This  makes  it
+       possible  for  an  application  to  check  for an extended capability's
+       presence with tigetstr, and reassign  the  keycode  to  match  its  own
+       needs.
 
        Low-level applications can use tigetstr to obtain the definition of any
-       particular  string capability.  Higher-level applications which use the
-       curses wgetch and similar functions to return keycodes  rely  upon  the
+       particular string capability.  Higher-level applications which use  the
+       curses  wgetch  and  similar functions to return keycodes rely upon the
        order in which the strings are loaded.  If more than one key definition
-       has the same string value, then wgetch can  return  only  one  keycode.
+       has  the  same  string  value, then wgetch can return only one keycode.
        Most curses implementations (including ncurses) load key definitions in
-       the order defined by the array of string capability  names.   The  last
-       key  to  be  loaded  determines the keycode which will be returned.  In
-       ncurses, you may also have extended  capabilities  interpreted  as  key
-       definitions.   These are loaded after the predefined keys, and if a ca-
-       pability's value is the same as a previously-loaded key definition, the
-       later definition is the one used.
+       the  order  defined  by the array of string capability names.  The last
+       key to be loaded determines the keycode which  will  be  returned.   In
+       ncurses,  you  may  also  have extended capabilities interpreted as key
+       definitions.  These are loaded after the  predefined  keys,  and  if  a
+       capability's  value  is the same as a previously-loaded key definition,
+       the later definition is the one used.

NOTES

-       Note  that echo, noecho, halfdelay, intrflush, meta, nl, nonl, nodelay,
+       Note that echo, noecho, halfdelay, intrflush, meta, nl, nonl,  nodelay,
        notimeout, noqiflush, qiflush, timeout, and wtimeout may be macros.
 
-       The noraw and nocbreak calls follow historical practice  in  that  they
-       attempt  to restore to normal ("cooked") mode from raw and cbreak modes
-       respectively.  Mixing raw/noraw and cbreak/nocbreak calls leads to  tty
+       The  noraw  and  nocbreak calls follow historical practice in that they
+       attempt to restore to normal ("cooked") mode from raw and cbreak  modes
+       respectively.   Mixing raw/noraw and cbreak/nocbreak calls leads to tty
        driver control states that are hard to predict or understand; it is not
        recommended.

curs_ins_wch 3x 2022-02-12 ncurses 6.4 Library calls

curs_ins_wch 3x 2023-09-16 ncurses 6.4 Library calls

 curs_ins_wch(3x)                 Library calls                curs_ins_wch(3x)
 
@@ -47,8 +47,8 @@

NAME

-       ins_wch,  mvins_wch,  mvwins_wch, wins_wch - insert a complex character
-       and rendition into a window
+       ins_wch,  mvins_wch,  mvwins_wch,  wins_wch  -  insert a curses complex
+       character string in a window

SYNOPSIS

@@ -86,7 +86,7 @@
 
 
 
-ncurses 6.4                       2022-02-12                  curs_ins_wch(3x)
+ncurses 6.4                       2023-09-16                  curs_ins_wch(3x)

curs_ins_wstr 3x 2022-02-12 ncurses 6.4 Library calls

curs_ins_wstr 3x 2023-09-16 ncurses 6.4 Library calls

curs_ins_wstr 3x 2022-02-12 ncurses 6.4 Library calls

curs_ins_wstr 3x 2023-09-16 ncurses 6.4 Library calls

 curs_ins_wstr(3x)                Library calls               curs_ins_wstr(3x)
 
@@ -47,9 +47,9 @@

NAME

-       ins_wstr, ins_nwstr, wins_wstr, wins_nwstr, mvins_wstr, mvins_nwstr,
-       mvwins_wstr, mvwins_nwstr - insert a wide-character string into a
-       curses window
+       ins_wstr,  ins_nwstr,  wins_wstr,  wins_nwstr, mvins_wstr, mvins_nwstr,
+       mvwins_wstr, mvwins_nwstr - insert a wide-character string in a  curses
+       window

SYNOPSIS

@@ -68,13 +68,13 @@

DESCRIPTION

        These routines insert a wchar_t character string (as many characters as
-       will fit on the line) before the character under the cursor.  All char-
-       acters to the right of the cursor are shifted right, with the possibil-
-       ity of the rightmost characters on the line being lost.  No wrapping is
-       performed.   The cursor position does not change (after moving to y, x,
-       if specified).  The four routines with n as the last argument insert  a
-       leading  substring  of at most n wchar_t characters.  If n is less than
-       1, the entire string is inserted.
+       will fit on the line) before  the  character  under  the  cursor.   All
+       characters  to  the  right  of  the  cursor are shifted right, with the
+       possibility of the rightmost characters on the  line  being  lost.   No
+       wrapping  is  performed.   The  cursor  position does not change (after
+       moving to y, x, if specified).  The four routines with n  as  the  last
+       argument  insert  a  leading substring of at most n wchar_t characters.
+       If n is less than 1, the entire string is inserted.
 
        If a character in wstr is a tab, newline, carriage return or backspace,
        the  cursor  is  moved appropriately within the window.  A newline also
@@ -90,8 +90,8 @@
        Note that all but wins_nwstr may be macros.
 
        If  the  first character in the string is a nonspacing character, these
-       functions will fail.  XSI does not define what will happen  if  a  non-
-       spacing character follows a control character.
+       functions will fail.  XSI  does  not  define  what  will  happen  if  a
+       nonspacing character follows a control character.

RETURN VALUE

@@ -108,7 +108,7 @@
 
 
 
-ncurses 6.4                       2022-02-12                 curs_ins_wstr(3x)
+ncurses 6.4                       2023-09-16                 curs_ins_wstr(3x)

curs_insch 3x 2023-07-01 ncurses 6.4 Library calls

curs_insch 3x 2023-09-16 ncurses 6.4 Library calls

curs_insch 3x 2023-07-01 ncurses 6.4 Library calls

curs_insch 3x 2023-09-16 ncurses 6.4 Library calls

 curs_insch(3x)                   Library calls                  curs_insch(3x)
 
@@ -47,8 +47,8 @@

NAME

-       insch,  winsch, mvinsch, mvwinsch - insert a character before cursor in
-       a curses window
+       insch,  winsch,  mvinsch,  mvwinsch  -  insert  a curses character in a
+       window

SYNOPSIS

@@ -99,7 +99,7 @@
 
 
 
-ncurses 6.4                       2023-07-01                    curs_insch(3x)
+ncurses 6.4                       2023-09-16                    curs_insch(3x)

curs_insstr 3x 2023-07-01 ncurses 6.4 Library calls

curs_insstr 3x 2023-09-16 ncurses 6.4 Library calls

curs_insstr 3x 2023-07-01 ncurses 6.4 Library calls

curs_insstr 3x 2023-09-16 ncurses 6.4 Library calls

 curs_insstr(3x)                  Library calls                 curs_insstr(3x)
 
@@ -48,7 +48,7 @@

NAME

        insstr,  insnstr,  winsstr,  winsnstr,  mvinsstr, mvinsnstr, mvwinsstr,
-       mvwinsnstr - insert string before cursor in a curses window
+       mvwinsnstr - insert a string in a curses window

SYNOPSIS

@@ -110,7 +110,7 @@
 
 
 
-ncurses 6.4                       2023-07-01                   curs_insstr(3x)
+ncurses 6.4                       2023-09-16                   curs_insstr(3x)

curs_instr 3x 2023-07-01 ncurses 6.4 Library calls

curs_instr 3x 2023-09-16 ncurses 6.4 Library calls

curs_instr 3x 2023-07-01 ncurses 6.4 Library calls

curs_instr 3x 2023-09-16 ncurses 6.4 Library calls

 curs_instr(3x)                   Library calls                  curs_instr(3x)
 
@@ -48,7 +48,7 @@

NAME

        instr,  innstr, winstr, winnstr, mvinstr, mvinnstr, mvwinstr, mvwinnstr
-       - get a string of characters from a curses window
+       - get a string from a curses window

SYNOPSIS

@@ -106,7 +106,7 @@
 
 
 
-ncurses 6.4                       2023-07-01                    curs_instr(3x)
+ncurses 6.4                       2023-09-16                    curs_instr(3x)

curs_inwstr 3x 2023-07-01 ncurses 6.4 Library calls

curs_inwstr 3x 2023-09-16 ncurses 6.4 Library calls

curs_inwstr 3x 2023-07-01 ncurses 6.4 Library calls

curs_inwstr 3x 2023-09-16 ncurses 6.4 Library calls

 curs_inwstr(3x)                  Library calls                 curs_inwstr(3x)
 
@@ -48,7 +48,7 @@

NAME

        inwstr,  innwstr,  winwstr,  winnwstr,  mvinwstr, mvinnwstr, mvwinwstr,
-       mvwinnwstr - get a string of wchar_t characters from a curses window
+       mvwinnwstr - get a wide-character string from a curses window

SYNOPSIS

@@ -102,7 +102,7 @@
 
 
 
-ncurses 6.4                       2023-07-01                   curs_inwstr(3x)
+ncurses 6.4                       2023-09-16                   curs_inwstr(3x)

curs_kernel 3x 2023-08-19 ncurses 6.4 Library calls

curs_kernel 3x 2023-09-16 ncurses 6.4 Library calls

curs_kernel 3x 2023-08-19 ncurses 6.4 Library calls

curs_kernel 3x 2023-09-16 ncurses 6.4 Library calls

 curs_kernel(3x)                  Library calls                 curs_kernel(3x)
 
@@ -47,9 +47,9 @@

NAME

-       def_prog_mode, def_shell_mode, reset_prog_mode, reset_shell_mode,
-       resetty, savetty, getsyx, setsyx, ripoffline, curs_set, napms - low-
-       level curses routines
+       def_prog_mode,   def_shell_mode,   reset_prog_mode,   reset_shell_mode,
+       resetty, savetty, getsyx, setsyx, ripoffline, curs_set,  napms  -  low-
+       level curses routines

SYNOPSIS

@@ -73,83 +73,84 @@

DESCRIPTION

-       The following routines give low-level access to various curses capabil-
-       ities.  These routines typically are used inside library routines.
+       The   following  routines  give  low-level  access  to  various  curses
+       capabilities.   These  routines  typically  are  used  inside   library
+       routines.

def_prog_mode, def_shell_mode

        The def_prog_mode and def_shell_mode routines save the current terminal
        modes as the "program" (in curses) or "shell" (not in curses) state for
        use by the reset_prog_mode and reset_shell_mode routines.  This is done
-       automatically  by initscr.  There is one such save area for each screen
+       automatically by initscr.  There is one such save area for each  screen
        context allocated by newterm.

reset_prog_mode, reset_shell_mode

-       The reset_prog_mode and reset_shell_mode routines restore the  terminal
-       to  "program"  (in curses) or "shell" (out of curses) state.  These are
-       done automatically by endwin(3x) and, after an endwin, by doupdate,  so
+       The  reset_prog_mode and reset_shell_mode routines restore the terminal
+       to "program" (in curses) or "shell" (out of curses) state.   These  are
+       done  automatically by endwin(3x) and, after an endwin, by doupdate, so
        they normally are not called.

resetty, savetty

-       The resetty and savetty routines save and restore the state of the ter-
-       minal modes.  savetty saves the current state in a buffer  and  resetty
-       restores the state to what it was at the last call to savetty.
+       The resetty and savetty routines save and  restore  the  state  of  the
+       terminal  modes.   savetty  saves  the  current  state  in a buffer and
+       resetty restores the state to what it was at the last call to savetty.

getsyx

-       The  getsyx  routine  returns  the  current  coordinates of the virtual
-       screen cursor in y and x.  If leaveok is currently TRUE, then -1,-1  is
+       The getsyx routine returns  the  current  coordinates  of  the  virtual
+       screen  cursor in y and x.  If leaveok is currently TRUE, then -1,-1 is
        returned.  If lines have been removed from the top of the screen, using
-       ripoffline, y and x include these lines; therefore, y and x  should  be
+       ripoffline,  y  and x include these lines; therefore, y and x should be
        used only as arguments for setsyx.
 
        Few applications will use this feature, most use getyx instead.

setsyx

-       The  setsyx routine sets the virtual screen cursor to y, x.  If y and x
-       are both -1, then leaveok is set.  The two routines getsyx  and  setsyx
-       are  designed to be used by a library routine, which manipulates curses
-       windows but does not want to change the current position  of  the  pro-
-       gram's cursor.  The library routine would call getsyx at the beginning,
-       do its manipulation of its own windows, do a wnoutrefresh on  its  win-
-       dows, call setsyx, and then call doupdate.
+       The setsyx routine sets the virtual screen cursor to y, x.  If y and  x
+       are  both  -1, then leaveok is set.  The two routines getsyx and setsyx
+       are designed to be used by a library routine, which manipulates  curses
+       windows  but  does  not  want  to  change  the  current position of the
+       program's cursor.   The  library  routine  would  call  getsyx  at  the
+       beginning, do its manipulation of its own windows, do a wnoutrefresh on
+       its windows, call setsyx, and then call doupdate.
 
        Few applications will use this feature, most use wmove instead.

ripoffline

-       The  ripoffline  routine  provides  access  to  the  same facility that
-       slk_init [see curs_slk(3x)] uses to reduce  the  size  of  the  screen.
-       ripoffline  must be called before initscr or newterm is called, to pre-
-       pare these initial actions:
+       The ripoffline routine  provides  access  to  the  same  facility  that
+       slk_init  [see  curs_slk(3x)]  uses  to  reduce the size of the screen.
+       ripoffline must be called before  initscr  or  newterm  is  called,  to
+       prepare these initial actions:
 
        o   If line is positive, a line is removed from the top of stdscr.
 
        o   if line is negative, a line is removed from the bottom.
 
-       When the resulting initialization is done inside initscr,  the  routine
+       When  the  resulting initialization is done inside initscr, the routine
        init (supplied by the user) is called with two arguments:
 
        o   a window pointer to the one-line window that has been allocated and
 
        o   an integer with the number of columns in the window.
 
-       Inside  this  initialization  routine,  the integer variables LINES and
-       COLS (defined in <curses.h>) are not guaranteed to be accurate and wre-
-       fresh or doupdate must not be called.  It is allowable to call wnoutre-
-       fresh during the initialization routine.
+       Inside this initialization routine, the  integer  variables  LINES  and
+       COLS  (defined  in  <curses.h>)  are  not guaranteed to be accurate and
+       wrefresh or doupdate must not be  called.   It  is  allowable  to  call
+       wnoutrefresh during the initialization routine.
 
-       ripoffline can be called up to five times  before  calling  initscr  or
+       ripoffline  can  be  called  up to five times before calling initscr or
        newterm.

curs_set

-       The  curs_set  routine  sets  the cursor state to invisible, normal, or
-       very visible for visibility equal to 0, 1, or 2 respectively.   If  the
-       terminal  supports  the visibility requested, the previous cursor state
+       The curs_set routine sets the cursor state  to  invisible,  normal,  or
+       very  visible  for visibility equal to 0, 1, or 2 respectively.  If the
+       terminal supports the visibility requested, the previous  cursor  state
        is returned; otherwise, ERR is returned.
 
 
@@ -160,7 +161,7 @@

RETURN VALUE

        Except for curs_set, these routines always return OK.
 
-       curs_set returns the previous cursor state, or  ERR  if  the  requested
+       curs_set  returns  the  previous  cursor state, or ERR if the requested
        visibility is not supported.
 
        X/Open defines no error conditions.  In this implementation
@@ -171,30 +172,30 @@
 
        ripoffline
             returns an error if the maximum number of ripped-off lines exceeds
-            the maximum (NRIPS = 5).
+            the maximum (5).

NOTES

        Note that getsyx is a macro, so & is not necessary before the variables
        y and x.
 
-       Older SVr4 man pages warn that the return value of  curs_set  "is  cur-
-       rently  incorrect".   This  implementation gets it right, but it may be
+       Older  SVr4  man  pages  warn  that  the  return  value of curs_set "is
+       currently incorrect".  This implementation gets it right, but it may be
        unwise to count on the correctness of the return value anywhere else.
 
        Both ncurses and SVr4 will call curs_set in endwin if curs_set has been
-       called  to make the cursor other than normal, i.e., either invisible or
-       very visible.  There is no way for ncurses  to  determine  the  initial
+       called to make the cursor other than normal, i.e., either invisible  or
+       very  visible.   There  is  no way for ncurses to determine the initial
        cursor state to restore that.

PORTABILITY

        The virtual screen functions setsyx and getsyx are not described in the
-       XSI Curses standard, Issue 4.  All other functions are as described  in
+       XSI  Curses standard, Issue 4.  All other functions are as described in
        XSI Curses.
 
-       The  SVr4  documentation  describes  setsyx and getsyx as having return
-       type int.  This is misleading, as they are macros  with  no  documented
+       The SVr4 documentation describes setsyx and  getsyx  as  having  return
+       type  int.   This  is misleading, as they are macros with no documented
        semantics for the return value.
 
 
@@ -204,7 +205,7 @@
 
 
 
-ncurses 6.4                       2023-08-19                   curs_kernel(3x)
+ncurses 6.4                       2023-09-16                   curs_kernel(3x)

curs_legacy 3x 2023-07-01 ncurses 6.4 Library calls

curs_legacy 3x 2023-09-16 ncurses 6.4 Library calls

curs_legacy 3x 2023-07-01 ncurses 6.4 Library calls

curs_legacy 3x 2023-09-16 ncurses 6.4 Library calls

 curs_legacy(3x)                  Library calls                 curs_legacy(3x)
 
@@ -47,7 +47,9 @@

NAME

-       curs_legacy - get curses cursor and window coordinates, attributes
+       getattrs,   getbegx,   getbegy,  getcurx,  getcury,  getmaxx,  getmaxy,
+       getparx,  getpary  -  get  curses  cursor  and  window  coordinates  or
+       attributes (legacy)

SYNOPSIS

@@ -123,7 +125,7 @@
 
 
 
-ncurses 6.4                       2023-07-01                   curs_legacy(3x)
+ncurses 6.4                       2023-09-16                   curs_legacy(3x)

curs_memleaks 3x 2022-06-04 ncurses 6.4 Library calls

curs_memleaks 3x 2023-09-16 ncurses 6.4 Library calls

curs_memleaks 3x 2022-06-04 ncurses 6.4 Library calls

curs_memleaks 3x 2023-09-16 ncurses 6.4 Library calls

 curs_memleaks(3x)                Library calls               curs_memleaks(3x)
 
@@ -47,7 +47,7 @@

NAME

-       exit_curses, exit_terminfo - curses memory-leak checking
+       exit_curses, exit_terminfo - check for memory leaks in curses

SYNOPSIS

@@ -70,11 +70,11 @@
        Any implementation of curses must not free the memory associated with a
        screen, since (even after calling endwin(3x)), it must be available for
        use in the next call to refresh(3x).  There are also chunks  of  memory
-       held for performance reasons.  That makes it hard to analyze curses ap-
-       plications for memory leaks.  When using the specially  configured  de-
-       bugging version of the ncurses library, applications can call functions
-       which free those chunks of memory, simplifying the process  of  memory-
-       leak checking.
+       held  for  performance  reasons.   That makes it hard to analyze curses
+       applications for memory leaks.  When  using  the  specially  configured
+       debugging  version  of  the  ncurses  library,  applications  can  call
+       functions which free those chunks of memory, simplifying the process of
+       memory-leak checking.
 
        Some  of  the functions are named with a "_nc_" prefix because they are
        not intended for use in the non-debugging library:
@@ -85,8 +85,8 @@
        _nc_free_and_exit
             This frees the memory allocated by ncurses (like _nc_freeall), and
             exits the program.  It is preferred over _nc_freeall since some of
-            that memory may be required to keep the application running.  Sim-
-            ply exiting (with the given exit-code) is safer.
+            that memory may be  required  to  keep  the  application  running.
+            Simply exiting (with the given exit-code) is safer.
 
        _nc_free_tinfo
             Use  this  function  if only the low-level terminfo functions (and
@@ -94,9 +94,9 @@
             the program after freeing memory.
 
        The  functions  prefixed "_nc" are normally not available; they must be
-       configured into the library at build time using the --disable-leaks op-
-       tion.   That compiles-in code that frees memory that normally would not
-       be freed.
+       configured into the library at build  time  using  the  --disable-leaks
+       option.   That  compiles-in  code that frees memory that normally would
+       not be freed.
 
        The exit_curses and exit_terminfo functions call _nc_free_and_exit  and
        _nc_free_tinfo  if  the  library  is  configured to support memory-leak
@@ -109,8 +109,8 @@

PORTABILITY

-       These functions are not part of X/Open Curses; nor do other implementa-
-       tions of curses provide a similar feature.
+       These   functions   are  not  part  of  X/Open  Curses;  nor  do  other
+       implementations of curses provide a similar feature.
 
        In any implementation of X/Open Curses, an application can free part of
        the memory allocated by curses:
@@ -132,7 +132,7 @@
 
 
 
-ncurses 6.4                       2022-06-04                 curs_memleaks(3x)
+ncurses 6.4                       2023-09-16                 curs_memleaks(3x)

curs_mouse 3x 2023-09-09 ncurses 6.4 Library calls

curs_mouse 3x 2023-09-16 ncurses 6.4 Library calls

curs_mouse 3x 2023-09-09 ncurses 6.4 Library calls

curs_mouse 3x 2023-09-16 ncurses 6.4 Library calls

 curs_mouse(3x)                   Library calls                  curs_mouse(3x)
 
@@ -48,8 +48,8 @@

NAME

-       has_mouse, getmouse, ungetmouse, mousemask, wenclose, mouse_trafo,
-       wmouse_trafo, mouseinterval - mouse interface through curses
+       has_mouse,  getmouse,  ungetmouse,  mousemask,  wenclose,  mouse_trafo,
+       wmouse_trafo, mouseinterval - get mouse events in curses

SYNOPSIS

@@ -87,8 +87,8 @@

mousemask

        To make mouse events visible, use the mousemask  function.   This  sets
-       the  mouse  events to be reported.  By default, no mouse events are re-
-       ported.
+       the  mouse  events  to  be  reported.   By default, no mouse events are
+       reported.
 
        o   The function returns an updated copy of newmask to  indicate  which
            of the specified mouse events can be reported.
@@ -155,11 +155,11 @@
        event off the queue, call getmouse.  This function will return OK if  a
        mouse  event  is  actually  visible in the given window, ERR otherwise.
        When getmouse returns OK, the data deposited as y and x  in  the  event
-       structure  coordinates  will  be screen-relative character-cell coordi-
-       nates.  The returned state mask will have exactly one bit set to  indi-
-       cate the event type.  The corresponding data in the queue is marked in-
-       valid.  A subsequent call to getmouse will retrieve the next older item
-       from the queue.
+       structure    coordinates   will   be   screen-relative   character-cell
+       coordinates.  The returned state mask will have exactly one bit set  to
+       indicate the event type.  The corresponding data in the queue is marked
+       invalid.  A subsequent call to getmouse will retrieve  the  next  older
+       item from the queue.

ungetmouse

@@ -178,29 +178,29 @@

wmouse_trafo

        The wmouse_trafo function transforms a given pair of  coordinates  from
        stdscr-relative coordinates to coordinates relative to the given window
-       or vice versa.  The resulting stdscr-relative coordinates are  not  al-
-       ways  identical  to window-relative coordinates due to the mechanism to
+       or vice versa.   The  resulting  stdscr-relative  coordinates  are  not
+       always identical to window-relative coordinates due to the mechanism to
        reserve lines on top or bottom of the screen for  other  purposes  (see
        the ripoffline and slk_init(3x) calls, for example).
 
-       o   If the parameter to_screen is TRUE, the pointers pY, pX must refer-
-           ence the coordinates of a location inside the window win.  They are
-           converted  to  window-relative coordinates and returned through the
-           pointers.  If the conversion was successful, the  function  returns
-           TRUE.
+       o   If  the  parameter  to_screen  is  TRUE,  the  pointers pY, pX must
+           reference the coordinates of a  location  inside  the  window  win.
+           They  are  converted  to  window-relative  coordinates and returned
+           through the  pointers.   If  the  conversion  was  successful,  the
+           function returns TRUE.
 
        o   If one of the parameters was NULL or the location is not inside the
            window, FALSE is returned.
 
        o   If to_screen is FALSE, the pointers pY, pX must  reference  window-
-           relative  coordinates.  They are converted to stdscr-relative coor-
-           dinates if the window win encloses this point.  In  this  case  the
-           function returns TRUE.
+           relative   coordinates.   They  are  converted  to  stdscr-relative
+           coordinates if the window win encloses this point.   In  this  case
+           the function returns TRUE.
 
        o   If  one  of  the  parameters is NULL or the point is not inside the
-           window, FALSE is returned.  The referenced coordinates are only re-
-           placed  by the converted coordinates if the transformation was suc-
-           cessful.
+           window, FALSE is returned.  The  referenced  coordinates  are  only
+           replaced  by  the  converted  coordinates if the transformation was
+           successful.

mouse_trafo

@@ -211,15 +211,15 @@

mouseinterval

        The  mouseinterval  function  sets  the maximum time (in thousands of a
        second) that can elapse between press and release events for them to be
-       recognized  as  a click.  Use mouseinterval(0) to disable click resolu-
-       tion.  This function returns the previous interval value.  Use mousein-
-       terval(-1)  to obtain the interval without altering it.  The default is
-       one sixth of a second.
+       recognized   as   a  click.   Use  mouseinterval(0)  to  disable  click
+       resolution.  This function returns the previous  interval  value.   Use
+       mouseinterval(-1)  to  obtain  the  interval  without altering it.  The
+       default is one sixth of a second.

has_mouse

-       The has_mouse function returns TRUE if the mouse driver has  been  suc-
-       cessfully initialized.
+       The has_mouse function returns  TRUE  if  the  mouse  driver  has  been
+       successfully initialized.
 
        Note  that  mouse  events will be ignored when input is in cooked mode,
        and will cause an error beep when cooked mode is being simulated  in  a
@@ -287,8 +287,8 @@
            For instance the SVr4 curses library used the get_mouse  capability
            to  tell  the  terminal  which  mouse button events it should send,
            passing the mouse-button bit-mask to the terminal.  Also, it  could
-           ask  the terminal where the mouse was using the req_mouse_pos capa-
-           bility.
+           ask  the  terminal  where  the  mouse  was  using the req_mouse_pos
+           capability.
 
            Those features required a terminal which had been modified to  work
            with curses.  They were not part of the X Consortium's xterm.
@@ -297,22 +297,22 @@
        Eric Raymond was uninterested in using the same interface  due  to  its
        lack of documentation.  Later, in 1998, Mark Hesseling provided support
        in PDCurses 2.3 using the SVr4 interface.  PDCurses, however, does  not
-       use  video  terminals, making it unnecessary to be concerned about com-
-       patibility with the escape sequences.
+       use  video  terminals,  making  it  unnecessary  to  be concerned about
+       compatibility with the escape sequences.
 
        The feature macro NCURSES_MOUSE_VERSION is provided so the preprocessor
-       can  be used to test whether these features are present.  If the inter-
-       face is changed, the value of NCURSES_MOUSE_VERSION will be  increment-
-       ed.   These values for NCURSES_MOUSE_VERSION may be specified when con-
-       figuring ncurses:
+       can  be  used  to  test  whether  these  features  are present.  If the
+       interface is  changed,  the  value  of  NCURSES_MOUSE_VERSION  will  be
+       incremented.   These  values for NCURSES_MOUSE_VERSION may be specified
+       when configuring ncurses:
 
           1  has definitions for reserved events.  The mask uses 28 bits.
 
-          2  adds definitions for button 5, removes the  definitions  for  re-
-             served events.  The mask uses 29 bits.
+          2  adds definitions  for  button  5,  removes  the  definitions  for
+             reserved events.  The mask uses 29 bits.
 
-       The order of the MEVENT structure members is not guaranteed.  Addition-
-       al fields may be added to the structure in the future.
+       The   order   of  the  MEVENT  structure  members  is  not  guaranteed.
+       Additional fields may be added to the structure in the future.
 
        Under ncurses(3x), these calls are  implemented  using  either  xterm's
        built-in mouse-tracking API or platform-specific drivers including
@@ -338,9 +338,9 @@
 
           \E[?1006;1000%?%p1%{1}%=%th%el%;
 
-       The z member in the event structure is not presently used.  It  is  in-
-       tended  for use with touch screens (which may be pressure-sensitive) or
-       with 3D-mice/trackballs/power gloves.
+       The z member in the event structure  is  not  presently  used.   It  is
+       intended  for  use with touch screens (which may be pressure-sensitive)
+       or with 3D-mice/trackballs/power gloves.
 
        The ALL_MOUSE_EVENTS  class  does  not  include  REPORT_MOUSE_POSITION.
        They  are  distinct.   For example, in xterm, wheel/scrolling mice send
@@ -361,8 +361,8 @@
        i.e., it is the beginning of the response.
 
        Because there are no standard terminal responses that  would  serve  to
-       identify  terminals which support the xterm mouse protocol, ncurses as-
-       sumes that if kmous is defined in the terminal description, or  if  the
+       identify  terminals  which  support  the  xterm mouse protocol, ncurses
+       assumes that if kmous is defined in the terminal description, or if the
        terminal  description's  primary  name  or  aliases  contain the string
        "xterm", then the terminal may send mouse events.  The kmous capability
        is  checked first, allowing the use of newer xterm mouse protocols such
@@ -370,12 +370,12 @@

curs_move 3x 2023-07-01 ncurses 6.4 Library calls

curs_move 3x 2023-09-16 ncurses 6.4 Library calls

 curs_move(3x)                    Library calls                   curs_move(3x)
 
@@ -47,7 +47,7 @@

NAME

-       move, wmove - move curses window cursor
+       move, wmove - move cursor in a curses window

SYNOPSIS

@@ -59,9 +59,9 @@

DESCRIPTION

        These routines move the cursor associated with the window to line y and
-       column x.  This routine does not move the physical cursor of the termi-
-       nal until refresh(3x) is called.  The position specified is relative to
-       the upper left-hand corner of the window, which is (0,0).
+       column x.  This routine does  not  move  the  physical  cursor  of  the
+       terminal  until  refresh(3x)  is  called.   The  position  specified is
+       relative to the upper left-hand corner of the window, which is (0,0).

RETURN VALUE

@@ -85,7 +85,7 @@
 
 
 
-ncurses 6.4                       2023-07-01                     curs_move(3x)
+ncurses 6.4                       2023-09-16                     curs_move(3x)

curs_opaque 3x 2023-07-01 ncurses 6.4 Library calls

curs_opaque 3x 2023-09-16 ncurses 6.4 Library calls

curs_opaque 3x 2023-07-01 ncurses 6.4 Library calls

curs_opaque 3x 2023-09-16 ncurses 6.4 Library calls

 curs_opaque(3x)                  Library calls                 curs_opaque(3x)
 
@@ -47,9 +47,9 @@

NAME

-       is_cleared, is_idlok, is_idcok, is_immedok, is_keypad, is_leaveok,
-       is_nodelay, is_notimeout, is_pad, is_scrollok, is_subwin, is_syncok,
-       wgetdelay, wgetparent, wgetscrreg - curses window properties
+       is_cleared,  is_idlok,  is_idcok,  is_immedok,  is_keypad,  is_leaveok,
+       is_nodelay, is_notimeout, is_pad,  is_scrollok,  is_subwin,  is_syncok,
+       wgetdelay, wgetparent, wgetscrreg - obtain curses window properties

SYNOPSIS

@@ -74,8 +74,8 @@

DESCRIPTION

        This  implementation  provides functions which return properties set in
-       the WINDOW structure, allowing it to be "opaque" if the  symbol  NCURS-
-       ES_OPAQUE is defined:
+       the WINDOW  structure,  allowing  it  to  be  "opaque"  if  the  symbol
+       NCURSES_OPAQUE is defined:
 
        is_cleared
             returns the value set in clearok(3x)
@@ -108,8 +108,8 @@
             returns the value set in scrollok(3x)
 
        is_subwin
-            returns  TRUE  if the window is a subwindow, i.e., created by sub-
-            win(3x) or derwin(3x)
+            returns  TRUE  if  the  window  is  a  subwindow, i.e., created by
+            subwin(3x) or derwin(3x)
 
        is_syncok
             returns the value set in syncok(3x)
@@ -118,8 +118,8 @@
             returns the delay timeout as set in wtimeout(3x).
 
        wgetparent
-            returns the parent WINDOW pointer for subwindows, or NULL for win-
-            dows having no parent.
+            returns the parent WINDOW pointer  for  subwindows,  or  NULL  for
+            windows having no parent.
 
        wgetscrreg
             returns the top and bottom rows for the scrolling margin as set in
@@ -137,8 +137,8 @@

PORTABILITY

        These routines are specific to ncurses.  They  were  not  supported  on
        Version 7, BSD or System V implementations.  It is recommended that any
-       code depending on ncurses extensions be conditioned using  NCURSES_VER-
-       SION.
+       code   depending   on   ncurses   extensions   be   conditioned   using
+       NCURSES_VERSION.

curs_outopts 3x 2023-07-01 ncurses 6.4 Library calls

curs_outopts 3x 2023-09-16 ncurses 6.4 Library calls

 curs_outopts(3x)                 Library calls                curs_outopts(3x)
 
@@ -47,8 +47,8 @@

NAME

-       clearok, idlok, idcok, immedok, leaveok, setscrreg, wsetscrreg,
-       scrollok - curses output options
+       clearok,   idlok,   idcok,  immedok,  leaveok,  setscrreg,  wsetscrreg,
+       scrollok - set curses output options

SYNOPSIS

@@ -66,9 +66,9 @@

DESCRIPTION

-       These routines set options that change the style of output within curs-
-       es.   All  options are initially FALSE, unless otherwise stated.  It is
-       not necessary to turn these options off before calling endwin(3x).
+       These routines set options that  change  the  style  of  output  within
+       curses.   All options are initially FALSE, unless otherwise stated.  It
+       is not necessary to turn these options off before calling endwin(3x).

clearok

@@ -84,117 +84,118 @@

idlok

        If idlok is called with TRUE as second argument, curses considers using
        the  hardware  insert/delete  line  feature  of  terminals so equipped.
-       Calling idlok with FALSE as second argument disables use of line inser-
-       tion  and deletion.  This option should be enabled only if the applica-
-       tion needs insert/delete line, for example, for a screen editor.  It is
-       disabled by default because insert/delete line tends to be visually an-
-       noying when used in applications where it is not really needed.  If in-
-       sert/delete line cannot be used, curses redraws the changed portions of
-       all lines.
+       Calling idlok with FALSE  as  second  argument  disables  use  of  line
+       insertion  and  deletion.   This  option  should be enabled only if the
+       application needs insert/delete line, for example, for a screen editor.
+       It  is  disabled  by  default  because  insert/delete  line tends to be
+       visually annoying when used in applications  where  it  is  not  really
+       needed.   If  insert/delete  line  cannot  be  used, curses redraws the
+       changed portions of all lines.

idcok

-       If idcok is called with FALSE as second argument, curses no longer con-
-       siders  using the hardware insert/delete character feature of terminals
-       so equipped.  Use of character insert/delete  is  enabled  by  default.
-       Calling  idcok with TRUE as second argument re-enables use of character
-       insertion and deletion.
+       If idcok is called with FALSE as  second  argument,  curses  no  longer
+       considers   using  the  hardware  insert/delete  character  feature  of
+       terminals so equipped.  Use of character insert/delete  is  enabled  by
+       default.   Calling idcok with TRUE as second argument re-enables use of
+       character insertion and deletion.

immedok

        If immedok is called with TRUE as argument, any change  in  the  window
-       image, such as the ones caused by waddch, wclrtobot, wscrl, etc., auto-
-       matically cause a call to wrefresh.  However, it  may  degrade  perfor-
-       mance  considerably, due to repeated calls to wrefresh.  It is disabled
-       by default.
+       image,  such  as  the  ones  caused  by waddch, wclrtobot, wscrl, etc.,
+       automatically cause a  call  to  wrefresh.   However,  it  may  degrade
+       performance  considerably,  due  to  repeated calls to wrefresh.  It is
+       disabled by default.

leaveok

        Normally, the hardware cursor is left at the  location  of  the  window
        cursor  being  refreshed.   The  leaveok option allows the cursor to be
-       left wherever the update happens to leave it.  It is useful for  appli-
-       cations  where  the  cursor  is not used, since it reduces the need for
-       cursor motions.
+       left wherever the update  happens  to  leave  it.   It  is  useful  for
+       applications  where  the  cursor is not used, since it reduces the need
+       for cursor motions.

scrollok

        The scrollok option controls what happens when the cursor of  a  window
        is  moved  off  the edge of the window or scrolling region, either as a
-       result of a newline action on the bottom line, or typing the last char-
-       acter of the last line.  If disabled, (bf is FALSE), the cursor is left
-       on the bottom line.  If enabled, (bf is TRUE), the window  is  scrolled
-       up one line (Note that to get the physical scrolling effect on the ter-
-       minal, it is also necessary to call idlok).
+       result of a newline action on the  bottom  line,  or  typing  the  last
+       character  of the last line.  If disabled, (bf is FALSE), the cursor is
+       left on the bottom line.  If enabled,  (bf  is  TRUE),  the  window  is
+       scrolled up one line (Note that to get the physical scrolling effect on
+       the terminal, it is also necessary to call idlok).

setscrreg/wsetscrreg

        The setscrreg and wsetscrreg routines allow the application  programmer
-       to set a software scrolling region in a window.  The top and bot param-
-       eters are the line  numbers  of  the  top  and  bottom  margin  of  the
-       scrolling region.  (Line 0 is the top line of the window.)  If this op-
-       tion and scrollok are enabled, an attempt to move off the bottom margin
-       line causes all lines in the scrolling region to scroll one line in the
-       direction of the first line.  Only the text of the window is  scrolled.
-       (Note  that this has nothing to do with the use of a physical scrolling
-       region capability in the terminal, like that in the VT100.  If idlok is
-       enabled and the terminal has either a scrolling region or insert/delete
-       line capability, they will probably be used by the output routines.)
+       to  set  a  software  scrolling  region  in  a window.  The top and bot
+       parameters are the line numbers of the top and  bottom  margin  of  the
+       scrolling  region.   (Line  0  is the top line of the window.)  If this
+       option and scrollok are enabled, an attempt  to  move  off  the  bottom
+       margin line causes all lines in the scrolling region to scroll one line
+       in the direction of the first line.  Only the text  of  the  window  is
+       scrolled.  (Note that this has nothing to do with the use of a physical
+       scrolling region capability in the terminal, like that  in  the  VT100.
+       If  idlok  is enabled and the terminal has either a scrolling region or
+       insert/delete line capability, they will probably be used by the output
+       routines.)

RETURN VALUE

-       The functions setscrreg and wsetscrreg return OK upon success  and  ERR
-       upon  failure.  All other routines that return an integer always return
+       The  functions  setscrreg and wsetscrreg return OK upon success and ERR
+       upon failure.  All other routines that return an integer always  return
        OK.
 
        X/Open Curses does not define any error conditions.
 
        In this implementation,
 
-       o   those functions that have a window pointer will return an error  if
+       o   those  functions that have a window pointer will return an error if
            the window pointer is null
 
-       o   wsetscrreg  returns  an error if the scrolling region limits extend
+       o   wsetscrreg returns an error if the scrolling region  limits  extend
            outside the window.
 
-       X/Open does not define any error conditions.  This  implementation  re-
-       turns an error if the window pointer is null.
+       X/Open  does  not  define  any  error  conditions.  This implementation
+       returns an error if the window pointer is null.

PORTABILITY

        These functions are described in the XSI Curses standard, Issue 4.
 
-       From the outset, ncurses used nl/nonl to control the conversion of new-
-       lines to carriage return/line-feed on output as  well  as  input.   XSI
-       Curses  documents only the use of these functions for input.  This dif-
-       ference arose from converting the  pcurses  source  (which  used  ioctl
-       calls  with  the sgttyb structure) to termios (i.e., the POSIX terminal
+       From the outset, ncurses used nl/nonl  to  control  the  conversion  of
+       newlines  to carriage return/line-feed on output as well as input.  XSI
+       Curses documents only the use  of  these  functions  for  input.   This
+       difference  arose  from converting the pcurses source (which used ioctl
+       calls with the sgttyb structure) to termios (i.e., the  POSIX  terminal
        interface).  In the former, both input and output were controlled via a
-       single  option  CRMOD,  while the latter separates these features.  Be-
-       cause that conversion interferes with output optimization, nl/nonl were
-       amended after ncurses 6.2 to eliminate their effect on output.
+       single  option  CRMOD,  while  the  latter  separates  these  features.
+       Because  that  conversion  interferes with output optimization, nl/nonl
+       were amended after ncurses 6.2 to eliminate their effect on output.
 
-       Some  historic  curses implementations had, as an undocumented feature,
-       the ability to do the equivalent of clearok(..., 1)  by  saying  touch-
-       win(stdscr) or clear(stdscr).  This will not work under ncurses.
+       Some historic curses implementations had, as an  undocumented  feature,
+       the  ability  to  do  the  equivalent  of  clearok(...,  1)  by  saying
+       touchwin(stdscr) or clear(stdscr).  This will not work under ncurses.
 
-       Earlier  System  V  curses implementations specified that with scrollok
-       enabled, any window modification triggering  a  scroll  also  forced  a
+       Earlier System V curses implementations specified  that  with  scrollok
+       enabled,  any  window  modification  triggering  a scroll also forced a
        physical refresh.  XSI Curses does not require this, and ncurses avoids
-       doing it to perform better  vertical-motion  optimization  at  wrefresh
+       doing  it  to  perform  better vertical-motion optimization at wrefresh
        time.
 
        The XSI Curses standard does not mention that the cursor should be made
-       invisible as a side-effect of leaveok.  SVr4 curses documentation  does
-       this,  but  the code does not.  Use curs_set to make the cursor invisi-
-       ble.
+       invisible  as a side-effect of leaveok.  SVr4 curses documentation does
+       this, but  the  code  does  not.   Use  curs_set  to  make  the  cursor
+       invisible.

NOTES

-       Note that clearok, leaveok,  scrollok,  idcok,  and  setscrreg  may  be
+       Note  that  clearok,  leaveok,  scrollok,  idcok,  and setscrreg may be
        macros.
 
-       The immedok routine is useful for windows that are used as terminal em-
-       ulators.
+       The immedok routine is useful for windows that  are  used  as  terminal
+       emulators.

curs_overlay 3x 2023-07-01 ncurses 6.4 Library calls

curs_overlay 3x 2023-09-16 ncurses 6.4 Library calls

 curs_overlay(3x)                 Library calls                curs_overlay(3x)
 
@@ -47,8 +47,8 @@

NAME

-       overlay, overwrite, copywin - overlay and manipulate overlapped curses
-       windows
+       overlay,  overwrite,  copywin  -  overlay curses windows and manipulate
+       them

SYNOPSIS

@@ -67,23 +67,23 @@
        The overlay and overwrite routines overlay srcwin  on  top  of  dstwin.
        scrwin and dstwin are not required to be the same size; only text where
        the two windows overlap is copied.  The difference is that  overlay  is
-       non-destructive  (blanks  are not copied) whereas overwrite is destruc-
-       tive.
+       non-destructive   (blanks   are   not   copied)  whereas  overwrite  is
+       destructive.

copywin

        The copywin routine provides a finer granularity of  control  over  the
-       overlay  and overwrite routines.  As in the prefresh routine, a rectan-
-       gle is specified in the  destination  window,  (dminrow,  dmincol)  and
-       (dmaxrow, dmaxcol), and the upper-left-corner coordinates of the source
-       window, (sminrow, smincol).  If the  argument  overlay  is  true,  then
-       copying is non-destructive, as in overlay.
+       overlay  and  overwrite  routines.   As  in  the  prefresh  routine,  a
+       rectangle is specified in the destination  window,  (dminrow,  dmincol)
+       and  (dmaxrow,  dmaxcol),  and the upper-left-corner coordinates of the
+       source window, (sminrow, smincol).  If the argument  overlay  is  true,
+       then copying is non-destructive, as in overlay.

RETURN VALUE

        Routines  that  return an integer return ERR upon failure, and OK (SVr4
-       only specifies "an integer value other than ERR") upon successful  com-
-       pletion.
+       only specifies "an integer  value  other  than  ERR")  upon  successful
+       completion.
 
        X/Open  defines  no error conditions.  In this implementation, copywin,
        overlay and overwrite return an error if either of the window  pointers
@@ -97,8 +97,8 @@

PORTABILITY

        The  XSI Curses standard, Issue 4 describes these functions (adding the
        const qualifiers).  It further specifies their behavior in the presence
-       of  characters with multibyte renditions (not yet supported in this im-
-       plementation).
+       of  characters  with  multibyte  renditions  (not yet supported in this
+       implementation).

curs_pad 3x 2023-07-01 ncurses 6.4 Library calls

curs_pad 3x 2023-09-16 ncurses 6.4 Library calls

 curs_pad(3x)                     Library calls                    curs_pad(3x)
 
@@ -48,7 +48,7 @@

NAME

        newpad, subpad, prefresh, pnoutrefresh, pechochar, pecho_wchar - create
-       and display curses pads
+       and display curses pads

SYNOPSIS

@@ -73,12 +73,12 @@
        A pad is like a window, except that it is not restricted by the  screen
        size,  and  is not necessarily associated with a particular part of the
        screen.  Pads can be used when a large window is  needed,  and  only  a
-       part  of  the  window will be on the screen at one time.  Automatic re-
-       freshes of pads (e.g., from scrolling or echoing of input) do  not  oc-
-       cur.
+       part  of  the  window  will  be  on  the screen at one time.  Automatic
+       refreshes of pads (e.g., from scrolling or echoing  of  input)  do  not
+       occur.
 
-       It  is  not  legal to call wrefresh with a pad as an argument; the rou-
-       tines prefresh or pnoutrefresh should be  called  instead.   Note  that
+       It  is  not  legal  to  call  wrefresh  with  a pad as an argument; the
+       routines prefresh or pnoutrefresh should be called instead.  Note  that
        these routines require additional parameters to specify the part of the
        pad to be displayed and the location on the screen to be used  for  the
        display.
@@ -86,8 +86,8 @@

subpad

        The  subpad routine creates and returns a pointer to a subwindow within
-       a pad with the given number of lines, nlines, and columns, ncols.   Un-
-       like  subwin,  which uses screen coordinates, the window is at position
+       a pad with the given number  of  lines,  nlines,  and  columns,  ncols.
+       Unlike subwin, which uses screen coordinates, the window is at position
        (begin_x, begin_y) on the pad.  The window is made in the middle of the
        window  orig,  so  that changes made to one window affect both windows.
        During the use of this routine, it will  often  be  necessary  to  call
@@ -100,8 +100,8 @@
        additional  parameters  are needed to indicate what part of the pad and
        screen are involved.
 
-       o   The pminrow and pmincol parameters specify the upper left-hand cor-
-           ner of the rectangle to be displayed in the pad.
+       o   The pminrow and pmincol  parameters  specify  the  upper  left-hand
+           corner of the rectangle to be displayed in the pad.
 
        o   The  sminrow,  smincol, smaxrow, and smaxcol parameters specify the
            edges of the rectangle to be displayed on the screen.
@@ -118,23 +118,23 @@
        followed  by a call to refresh(3x), a call to waddch followed by a call
        to wrefresh, or a call to waddch followed by a call to  prefresh.   The
        knowledge  that  only  a single character is being output is taken into
-       consideration and, for non-control characters, a  considerable  perfor-
-       mance  gain  might  be  seen  by  using these routines instead of their
+       consideration  and,  for   non-control   characters,   a   considerable
+       performance gain might be seen by using these routines instead of their
        equivalents.  In the case of pechochar, the last location of the pad on
        the screen is reused for the arguments to prefresh.

pecho_wchar

-       The  pecho_wchar  function  is the analogous wide-character form of pe-
-       chochar.  It outputs one character to a pad and  immediately  refreshes
-       the pad.  It does this by a call to wadd_wch followed by a call to pre-
-       fresh.
+       The  pecho_wchar  function  is  the  analogous  wide-character  form of
+       pechochar.  It outputs one character to a pad and immediately refreshes
+       the  pad.   It  does  this  by a call to wadd_wch followed by a call to
+       prefresh.

RETURN VALUE

        Routines that return an integer return ERR upon failure  and  OK  (SVr4
-       only  specifies "an integer value other than ERR") upon successful com-
-       pletion.
+       only  specifies  "an  integer  value  other  than ERR") upon successful
+       completion.
 
        Routines that return pointers return NULL on error, and  set  errno  to
        ENOMEM.
@@ -144,16 +144,16 @@
           prefresh and pnoutrefresh
                return an error if the window pointer is null, or if the window
                is not really a pad or if the  area  to  refresh  extends  off-
-               screen or if the minimum coordinates are greater than the maxi-
-               mum.
+               screen  or  if  the  minimum  coordinates  are greater than the
+               maximum.
 
           pechochar
-               returns an error if the window is not really a pad, and the as-
-               sociated call to wechochar returns an error.
+               returns an error if the window is not really  a  pad,  and  the
+               associated call to wechochar returns an error.
 
           pecho_wchar
-               returns an error if the window is not really a pad, and the as-
-               sociated call to wecho_wchar returns an error.
+               returns  an  error  if  the window is not really a pad, and the
+               associated call to wecho_wchar returns an error.

NOTES

@@ -163,18 +163,18 @@

PORTABILITY

        BSD curses has no pad feature.
 
-       SVr2 curses (1986) provided the newpad and related functions, document-
-       ing  them  in  a single line each.  SVr3 (1987) provided more extensive
-       documentation.
+       SVr2  curses  (1986)  provided  the  newpad  and   related   functions,
+       documenting  them  in  a  single  line each.  SVr3 (1987) provided more
+       extensive documentation.
 
        The documentation does not explain the term pad.  However,  the  Apollo
        Aegis workstation operating system supported a graphical pad feature:
 
-       o   These  graphical pads could be much larger than the computer's dis-
-           play.
+       o   These  graphical  pads  could  be  much  larger than the computer's
+           display.
 
-       o   The read-only output from a command could be scrolled back  to  in-
-           spect, and select text from the pad.
+       o   The read-only output from a  command  could  be  scrolled  back  to
+           inspect, and select text from the pad.
 
        The two uses may be related.
 
@@ -195,16 +195,16 @@
            returning ERR in that case.
 
            However,  it only sets the flag for subwindows if the parent window
-           is a pad.  Its newpad function does not set this information.  Con-
-           sequently, the check will never fail.
+           is a pad.  Its newpad  function  does  not  set  this  information.
+           Consequently, the check will never fail.
 
            It  makes no comparable check in pnoutrefresh, though interestingly
            enough, a comment in the source code states  that  the  lack  of  a
            check was an MKS extension.
 
        o   NetBSD  7 curses sets a flag in the WINDOW structure for newpad and
-           subpad, using this to help with the  distinction  between  wnoutre-
-           fresh and pnoutrefresh.
+           subpad,  using  this  to  help   with   the   distinction   between
+           wnoutrefresh and pnoutrefresh.
 
            It  does  not  check for the case where a subwindow is created in a
            pad using subwin or derwin.
@@ -223,8 +223,8 @@
        o   checks  in  both  wnoutrefresh and pnoutrefresh to ensure that pads
            and windows are handled distinctly, and
 
-       o   ensures that dupwin and getwin treat pads  versus  windows  consis-
-           tently.
+       o   ensures  that  dupwin  and  getwin  treat   pads   versus   windows
+           consistently.

curs_print 3x 2022-02-12 ncurses 6.4 Library calls

curs_print 3x 2023-09-16 ncurses 6.4 Library calls

 curs_print(3x)                   Library calls                  curs_print(3x)
 
@@ -47,7 +47,7 @@

NAME

-       mcprint - ship binary data to printer
+       mcprint - write binary data to printer using terminfo capabilities

SYNOPSIS

@@ -98,7 +98,7 @@
 
 
 
-ncurses 6.4                       2022-02-12                    curs_print(3x)
+ncurses 6.4                       2023-09-16                    curs_print(3x)

curs_printw 3x 2022-02-12 ncurses 6.4 Library calls

curs_printw 3x 2023-09-16 ncurses 6.4 Library calls

curs_printw 3x 2022-02-12 ncurses 6.4 Library calls

curs_printw 3x 2023-09-16 ncurses 6.4 Library calls

 curs_printw(3x)                  Library calls                 curs_printw(3x)
 
@@ -47,8 +47,8 @@

NAME

-       printw, wprintw, mvprintw, mvwprintw, vwprintw, vw_printw - print
-       formatted output in curses windows
+       printw,  wprintw,  mvprintw,  mvwprintw,  vwprintw,  vw_printw  - write
+       formatted output to curses windows

SYNOPSIS

@@ -67,19 +67,19 @@

DESCRIPTION

        The printw, wprintw, mvprintw and mvwprintw routines are  analogous  to
        printf  [see printf(3)].  In effect, the string that would be output by
-       printf is output instead as though waddstr were used on the given  win-
-       dow.
+       printf is output instead as though  waddstr  were  used  on  the  given
+       window.
 
        The  vwprintw  and  vw_printw  routines  are  analogous to vprintf [see
        printf(3)] and perform a wprintw using a variable argument  list.   The
-       third  argument  is a va_list, a pointer to a list of arguments, as de-
-       fined in <stdarg.h>.
+       third  argument  is  a  va_list,  a  pointer to a list of arguments, as
+       defined in <stdarg.h>.

RETURN VALUE

        Routines that return an integer return ERR upon failure  and  OK  (SVr4
-       only  specifies "an integer value other than ERR") upon successful com-
-       pletion.
+       only  specifies  "an  integer  value  other  than ERR") upon successful
+       completion.
 
        X/Open defines no error conditions.  In this implementation,  an  error
        may be returned if it cannot allocate enough memory for the buffer used
@@ -97,9 +97,9 @@
        standard.   It  did not use <varargs.h>, though that was available.  In
        1991 (a couple of years after SVr4 was generally available,  and  after
        the  C  standard  was published), other developers updated the library,
-       using <stdarg.h> internally in 4.4BSD curses.  Even with this  improve-
-       ment, BSD curses did not use function prototypes (or even declare func-
-       tions) in the <curses.h> header until 1992.
+       using  <stdarg.h>  internally  in  4.4BSD  curses.   Even   with   this
+       improvement,  BSD  curses  did  not  use  function  prototypes (or even
+       declare functions) in the <curses.h> header until 1992.
 
        SVr2 documented printw, wprintw  tersely  as  "printf  on  stdscr"  and
        tersely as "printf on win", respectively.
@@ -107,20 +107,22 @@
        SVr3  added  mvprintw,  and mvwprintw, with a three-line summary saying
        that they were analogous to printf(3), explaining that the string which
        would be output from printf(3) would instead be output using waddstr on
-       the given window.  SVr3 also added vwprintw, saying that the third  pa-
-       rameter  is a va_list, defined in <varargs.h>, and referring the reader
-       to the manual pages for varargs and vprintf for detailed descriptions.
+       the given window.  SVr3 also added  vwprintw,  saying  that  the  third
+       parameter  is  a  va_list,  defined  in  <varargs.h>, and referring the
+       reader to the  manual  pages  for  varargs  and  vprintf  for  detailed
+       descriptions.
 
-       SVr4 added  no  new  variations  of  printw,  but  provided  for  using
+       SVr4  added  no  new  variations  of  printw,  but  provided  for using
        <varargs.h> or <stdarg.h> to define the va_list type.
 
-       X/Open  Curses  added  vw_printw  to replace vwprintw, stating that its
+       X/Open Curses added vw_printw to replace  vwprintw,  stating  that  its
        va_list definition requires <stdarg.h>.

PORTABILITY

-       In this implementation, vw_printw and vwprintw are equivalent, to  sup-
-       port legacy applications.  However, the latter (vwprintw) is obsolete:
+       In  this  implementation,  vw_printw  and  vwprintw  are equivalent, to
+       support  legacy  applications.   However,  the  latter  (vwprintw)   is
+       obsolete:
 
        o   The  XSI  Curses  standard, Issue 4 described these functions.  The
            function vwprintw is marked TO BE WITHDRAWN, and is to be  replaced
@@ -142,7 +144,7 @@
 
 
 
-ncurses 6.4                       2022-02-12                   curs_printw(3x)
+ncurses 6.4                       2023-09-16                   curs_printw(3x)

curs_refresh 3x 2023-08-19 ncurses 6.4 Library calls

curs_refresh 3x 2023-09-16 ncurses 6.4 Library calls

curs_refresh 3x 2023-08-19 ncurses 6.4 Library calls

curs_refresh 3x 2023-09-16 ncurses 6.4 Library calls

 curs_refresh(3x)                 Library calls                curs_refresh(3x)
 
@@ -47,8 +47,8 @@

NAME

-       doupdate, redrawwin, refresh, wnoutrefresh, wredrawln, wrefresh -
-       refresh curses windows and lines
+       doupdate,  redrawwin,  refresh,  wnoutrefresh,  wredrawln,  wrefresh  -
+       refresh curses windows or lines thereupon

SYNOPSIS

@@ -67,19 +67,19 @@

refresh/wrefresh

        The refresh and wrefresh routines (or wnoutrefresh and  doupdate)  must
-       be called to get actual output to the terminal, as other routines mere-
-       ly manipulate data structures.  The routine wrefresh copies  the  named
-       window  to  the  physical  screen,  taking into account what is already
-       there to do optimizations.  The refresh routine is the same, using std-
-       scr  as  the  default window.  Unless leaveok(3x) has been enabled, the
-       physical cursor of the terminal is left at the location of  the  cursor
-       for that window.
+       be  called  to  get  actual  output  to the terminal, as other routines
+       merely manipulate data structures.  The  routine  wrefresh  copies  the
+       named  window  to  the  physical  screen,  taking  into account what is
+       already there to do optimizations.  The refresh routine  is  the  same,
+       using  stdscr  as  the  default  window.   Unless  leaveok(3x) has been
+       enabled, the physical cursor of the terminal is left at the location of
+       the cursor for that window.

wnoutrefresh/doupdate

        The wnoutrefresh and doupdate routines allow multiple updates with more
-       efficiency than wrefresh alone.  In addition to all the  window  struc-
-       tures,  curses  keeps  two  data  structures  representing the terminal
+       efficiency  than  wrefresh  alone.   In  addition  to  all  the  window
+       structures,  curses keeps two data structures representing the terminal
        screen:
 
        o   a physical screen, describing what is actually on the screen, and
@@ -98,40 +98,40 @@
        If the programmer wishes to output several windows at once, a series of
        calls to wrefresh results in  alternating  calls  to  wnoutrefresh  and
        doupdate,  causing  several  bursts  of output to the screen.  By first
-       calling wnoutrefresh for each window, it is then possible to call doup-
-       date  once,  resulting  in  only  one burst of output, with fewer total
+       calling wnoutrefresh for each window,  it  is  then  possible  to  call
+       doupdate  once, resulting in only one burst of output, with fewer total
        characters transmitted and less CPU time used.
 
-       If the win argument to wrefresh is the physical screen (i.e., the glob-
-       al  variable  curscr),  the screen is immediately cleared and repainted
-       from scratch.
+       If the win argument to wrefresh  is  the  physical  screen  (i.e.,  the
+       global   variable  curscr),  the  screen  is  immediately  cleared  and
+       repainted from scratch.
 
-       The phrase "copies the named window to the virtual screen" above is am-
-       biguous.   What actually happens is that all touched (changed) lines in
-       the window are copied to the virtual  screen.   This  affects  programs
+       The phrase "copies the named window to the  virtual  screen"  above  is
+       ambiguous.   What  actually happens is that all touched (changed) lines
+       in the window are copied to the virtual screen.  This affects  programs
        that use overlapping windows; it means that if two windows overlap, you
-       can refresh them in either order and the overlap region will  be  modi-
-       fied  only  when  it  is  explicitly  changed.  (But see the section on
+       can refresh them in  either  order  and  the  overlap  region  will  be
+       modified  only  when it is explicitly changed.  (But see the section on
        PORTABILITY below for a warning about exploiting this behavior.)

wredrawln/redrawwin

        The wredrawln routine indicates to curses that some  screen  lines  are
        corrupted  and  should  be  thrown away before anything is written over
-       them.  It touches the indicated lines (marking them changed).  The rou-
-       tine redrawwin touches the entire window.
+       them.  It touches the indicated  lines  (marking  them  changed).   The
+       routine redrawwin touches the entire window.

RETURN VALUE

        Routines  that  return an integer return ERR upon failure, and OK (SVr4
-       only specifies "an integer value other than ERR") upon successful  com-
-       pletion.
+       only specifies "an integer  value  other  than  ERR")  upon  successful
+       completion.
 
        X/Open does not define any error conditions.  In this implementation
 
           wnoutrefresh
-               returns  an error if the window pointer is null, or if the win-
-               dow is really a pad.
+               returns  an  error  if  the  window  pointer is null, or if the
+               window is really a pad.
 
           wredrawln
                returns an error if the associated call to touchln  returns  an
@@ -150,8 +150,8 @@
        in  historic  curses  versions (including SVr4).  It might be unwise to
        rely on either behavior in programs that might have to be  linked  with
        other curses implementations.  Instead, you can do an explicit touchwin
-       before the wnoutrefresh call to guarantee an entire-contents copy  any-
-       where.
+       before the wnoutrefresh  call  to  guarantee  an  entire-contents  copy
+       anywhere.

curs_scanw 3x 2022-02-12 ncurses 6.4 Library calls

curs_scanw 3x 2023-09-16 ncurses 6.4 Library calls

 curs_scanw(3x)                   Library calls                  curs_scanw(3x)
 
@@ -47,8 +47,8 @@

NAME

-       scanw, wscanw, mvscanw, mvwscanw, vwscanw, vw_scanw - convert formatted
-       input from a curses window
+       scanw,  wscanw,  mvscanw,  mvwscanw, vwscanw, vw_scanw - read formatted
+       input from a curses window

SYNOPSIS

@@ -163,7 +163,7 @@
 
 
 
-ncurses 6.4                       2022-02-12                    curs_scanw(3x)
+ncurses 6.4                       2023-09-16                    curs_scanw(3x)

curs_scr_dump 3x 2023-07-01 ncurses 6.4 Library calls

curs_scr_dump 3x 2023-09-16 ncurses 6.4 Library calls

curs_scr_dump 3x 2023-07-01 ncurses 6.4 Library calls

curs_scr_dump 3x 2023-09-16 ncurses 6.4 Library calls

 curs_scr_dump(3x)                Library calls               curs_scr_dump(3x)
 
@@ -47,8 +47,8 @@

NAME

-       scr_dump, scr_restore, scr_init, scr_set - read (write) a curses screen
-       from (to) a file
+       scr_dump,  scr_restore,  scr_init, scr_set - read/write a curses screen
+       from/to a file

SYNOPSIS

@@ -115,9 +115,9 @@
        The XSI Curses standard, Issue 4, describes these functions (adding the
        const qualifiers).
 
-       The SVr4 docs merely say under scr_init that the dump data is also con-
-       sidered invalid "if the time-stamp of the tty is old" but do not define
-       "old".
+       The SVr4 docs merely say under scr_init that  the  dump  data  is  also
+       considered  invalid  "if  the  time-stamp of the tty is old" but do not
+       define "old".

curs_scroll 3x 2023-08-19 ncurses 6.4 Library calls

curs_scroll 3x 2023-09-16 ncurses 6.4 Library calls

 curs_scroll(3x)                  Library calls                 curs_scroll(3x)
 
@@ -47,7 +47,7 @@

NAME

-       scroll, scrl, wscrl - scroll a curses window
+       scroll, scrl, wscrl - scroll a curses window

SYNOPSIS

@@ -60,9 +60,9 @@

DESCRIPTION

-       The  scroll routine scrolls the window up one line.  This involves mov-
-       ing the lines in the window data structure.  As an optimization, if the
-       scrolling  region  of  the  window  is  the entire screen, the physical
+       The  scroll  routine  scrolls  the  window  up one line.  This involves
+       moving the lines in the window data structure.  As an optimization,  if
+       the  scrolling  region of the window is the entire screen, the physical
        screen may be scrolled at the same time.
 
        For positive n, the scrl and wscrl routines  scroll  the  window  up  n
@@ -70,8 +70,8 @@
        This involves moving the lines in the window character image structure.
        The current cursor position is not changed.
 
-       For  these  functions  to  work,  scrolling  must be enabled via scrol-
-       lok(3x).
+       For   these   functions   to   work,  scrolling  must  be  enabled  via
+       scrollok(3x).

RETURN VALUE

@@ -94,8 +94,8 @@
        of smarter optimization of multiple scroll actions on the next update.
 
        Neither the SVr4 nor the XSI documentation specify whether the  current
-       attribute or current color-pair of blanks generated by the scroll func-
-       tion is zeroed.  Under this implementation it is.
+       attribute  or  current  color-pair  of  blanks  generated by the scroll
+       function is zeroed.  Under this implementation it is.

PORTABILITY

@@ -107,7 +107,7 @@
 
 
 
-ncurses 6.4                       2023-08-19                   curs_scroll(3x)
+ncurses 6.4                       2023-09-16                   curs_scroll(3x)

curs_slk 3x 2023-07-01 ncurses 6.4 Library calls

curs_slk 3x 2023-09-16 ncurses 6.4 Library calls

curs_slk 3x 2023-07-01 ncurses 6.4 Library calls

curs_slk 3x 2023-09-16 ncurses 6.4 Library calls

 curs_slk(3x)                     Library calls                    curs_slk(3x)
 
@@ -47,10 +47,10 @@

NAME

-       slk_init, slk_set, slk_wset, slk_refresh, slk_noutrefresh, slk_label,
-       slk_clear, slk_restore, slk_touch, slk_attron, slk_attrset,
-       slk_attroff, slk_attr_on, slk_attr_set, slk_attr_off, slk_attr,
-       slk_color, extended_slk_color - curses soft label routines
+       slk_init,  slk_set,  slk_wset, slk_refresh, slk_noutrefresh, slk_label,
+       slk_clear,    slk_restore,    slk_touch,    slk_attron,    slk_attrset,
+       slk_attroff,   slk_attr_on,   slk_attr_set,   slk_attr_off,   slk_attr,
+       slk_color, extended_slk_color - curses soft label key routines

SYNOPSIS

@@ -85,20 +85,21 @@

DESCRIPTION

        The slk* functions manipulate the set of soft function-key labels  that
-       exist on many terminals.  For those terminals that do not have soft la-
-       bels, curses takes over the bottom line of stdscr, reducing the size of
-       stdscr  and the variable LINES.  curses standardizes on eight labels of
-       up to eight characters each.  In addition to this, the  ncurses  imple-
-       mentation  supports  a  mode where it simulates 12 labels of up to five
-       characters each.  This is useful for PC-like enduser devices.   ncurses
-       simulates this mode by taking over up to two lines at the bottom of the
-       screen; it does not try to use any hardware support for this mode.
+       exist  on  many  terminals.   For those terminals that do not have soft
+       labels, curses takes over the bottom line of stdscr, reducing the  size
+       of  stdscr and the variable LINES.  curses standardizes on eight labels
+       of up to eight characters each.   In  addition  to  this,  the  ncurses
+       implementation  supports  a  mode where it simulates 12 labels of up to
+       five characters each.  This is  useful  for  PC-like  enduser  devices.
+       ncurses  simulates  this  mode  by  taking  over up to two lines at the
+       bottom of the screen; it does not try to use any hardware  support  for
+       this mode.

Initialization

-       The slk_init routine must  be  called  before  initscr  or  newterm  is
-       called.   If  initscr eventually uses a line from stdscr to emulate the
-       soft labels, then fmt determines how the labels  are  arranged  on  the
+       The  slk_init  routine  must  be  called  before  initscr or newterm is
+       called.  If initscr eventually uses a line from stdscr to  emulate  the
+       soft  labels,  then  fmt  determines how the labels are arranged on the
        screen:
 
           0  indicates a 3-2-3 arrangement of the labels.
@@ -112,7 +113,7 @@

Labels

-       The slk_set routine (and the slk_wset routine  for  the  wide-character
+       The  slk_set  routine  (and the slk_wset routine for the wide-character
        library) has three parameters:
 
           labnum
@@ -120,16 +121,16 @@
                3);
 
           label
-               is be the string to put on the label, up to eight (five if  fmt
-               in  slk_init is 2 or 3) characters in length.  A null string or
+               is  be the string to put on the label, up to eight (five if fmt
+               in slk_init is 2 or 3) characters in length.  A null string  or
                a null pointer sets up a blank label.
 
-          fmt  is either 0, 1, or 2, indicating whether the  label  is  to  be
+          fmt  is  either  0,  1,  or 2, indicating whether the label is to be
                left-justified,  centered,  or  right-justified,  respectively,
                within the label.
 
-       The slk_label routine returns the current label for label  number  lab-
-       num, with leading and trailing blanks stripped.
+       The  slk_label  routine  returns  the  current  label  for label number
+       labnum, with leading and trailing blanks stripped.

Screen updates

@@ -138,32 +139,32 @@
 
        The slk_clear routine clears the soft labels from the screen.
 
-       The slk_restore routine restores the soft labels to the screen after  a
+       The  slk_restore routine restores the soft labels to the screen after a
        slk_clear has been performed.
 
-       The  slk_touch routine forces all the soft labels to be output the next
+       The slk_touch routine forces all the soft labels to be output the  next
        time a slk_noutrefresh is performed.

Video attributes

-       The slk_attron, slk_attrset, slk_attroff and slk_attr  routines  corre-
-       spond  to  attron,  attrset,  attroff and attr_get, respectively.  They
-       have an effect only if soft labels are simulated on the bottom line  of
-       the  screen.   The default highlight for soft keys is A_STANDOUT (as in
-       System V curses, which does not document this fact).
+       The   slk_attron,   slk_attrset,   slk_attroff  and  slk_attr  routines
+       correspond to attron,  attrset,  attroff  and  attr_get,  respectively.
+       They  have  an  effect  only if soft labels are simulated on the bottom
+       line of the screen.  The default highlight for soft keys is  A_STANDOUT
+       (as in System V curses, which does not document this fact).

Colors

-       The slk_color routine corresponds to color_set.  It has an effect  only
+       The  slk_color routine corresponds to color_set.  It has an effect only
        if soft labels are simulated on the bottom line of the screen.
 
-       Because  slk_color  accepts  only short (signed 16-bit integer) values,
-       this implementation provides extended_slk_color which accepts an  inte-
-       ger value, e.g., 32-bits.
+       Because slk_color accepts only short (signed  16-bit  integer)  values,
+       this   implementation  provides  extended_slk_color  which  accepts  an
+       integer value, e.g., 32-bits.

RETURN VALUE

-       These  routines return ERR upon failure and OK (SVr4 specifies only "an
+       These routines return ERR upon failure and OK (SVr4 specifies only  "an
        integer value other than ERR") upon successful completion.
 
        X/Open defines no error conditions.  In this implementation
@@ -171,37 +172,37 @@
           slk_attr
                returns the attribute used for the soft keys.
 
-          slk_attroff, slk_attron, slk_clear, slk_noutrefresh, slk_refresh,
+          slk_attroff,  slk_attron,  slk_clear,  slk_noutrefresh, slk_refresh,
           slk_touch
-               return  an  error if the terminal or the softkeys were not ini-
-               tialized.
+               return an error if  the  terminal  or  the  softkeys  were  not
+               initialized.
 
           slk_attrset
-               returns an error if the terminal or the softkeys were not  ini-
-               tialized.
+               returns  an  error  if  the  terminal  or the softkeys were not
+               initialized.
 
           slk_attr_set
-               returns  an error if the terminal or the softkeys were not ini-
-               tialized, or the  color  pair  is  outside  the  range  0..COL-
-               OR_PAIRS-1.
+               returns an error if the  terminal  or  the  softkeys  were  not
+               initialized,   or   the   color   pair  is  outside  the  range
+               0..COLOR_PAIRS-1.
 
           slk_color
-               returns  an error if the terminal or the softkeys were not ini-
-               tialized, or the  color  pair  is  outside  the  range  0..COL-
-               OR_PAIRS-1.
+               returns an error if the  terminal  or  the  softkeys  were  not
+               initialized,   or   the   color   pair  is  outside  the  range
+               0..COLOR_PAIRS-1.
 
           slk_init
-               returns  an  error if the format parameter is outside the range
+               returns an error if the format parameter is outside  the  range
                0..3.
 
           slk_label
                returns NULL on error.
 
           slk_set
-               returns an error if the terminal or the softkeys were not  ini-
-               tialized, or the labnum parameter is outside the range of label
-               counts, or if the format parameter is outside the  range  0..2,
-               or if memory for the labels cannot be allocated.
+               returns  an  error  if  the  terminal  or the softkeys were not
+               initialized, or the labnum parameter is outside  the  range  of
+               label  counts,  or if the format parameter is outside the range
+               0..2, or if memory for the labels cannot be allocated.

HISTORY

@@ -230,31 +231,32 @@

EXTENSIONS

-       X/Open  Curses  documents the opts argument as reserved for future use,
-       saying that it must be null.  This implementation uses  that  parameter
+       X/Open Curses documents the opts argument as reserved for  future  use,
+       saying  that  it must be null.  This implementation uses that parameter
        in ABI 6 for the functions which have a color-pair parameter to support
        extended color pairs.
 
-       For  functions  which modify the color, e.g., slk_attr_set, if opts  is
-       set  it  is  treated  as a pointer to int, and used to  set  the  color
+       For   functions  which modify the color, e.g., slk_attr_set, if opts is
+       set it is treated as a pointer to int, and used  to   set   the   color
        pair instead of the short pair parameter.

NOTES

-       Most applications would use slk_noutrefresh because a wrefresh is like-
-       ly to follow soon.
+       Most  applications  would  use  slk_noutrefresh  because  a wrefresh is
+       likely to follow soon.

PORTABILITY

-       The  XSI  Curses  standard,  Issue 4, described the soft-key functions,
+       The XSI Curses standard, Issue 4,  described  the  soft-key  functions,
        with some differences from SVr4 curses:
 
-       o   It added functions like the SVr4  attribute-manipulation  functions
-           slk_attron,  slk_attroff, slk_attrset, but which use attr_t parame-
-           ters (rather than chtype), along with a reserved opts parameter.
+       o   It  added  functions like the SVr4 attribute-manipulation functions
+           slk_attron,  slk_attroff,  slk_attrset,  but   which   use   attr_t
+           parameters  (rather  than  chtype),  along  with  a  reserved  opts
+           parameter.
 
-           Two of these new functions (unlike the SVr4 functions) have no pro-
-           vision for color: slk_attr_on and slk_attr_off.
+           Two of these new functions (unlike  the  SVr4  functions)  have  no
+           provision for color: slk_attr_on and slk_attr_off.
 
            The third function (slk_attr_set) has a color-pair parameter.
 
@@ -275,12 +277,12 @@
        o   Soft-key groups are an array of ng integers.
 
        o   In  SVr4, slk_init calls slk_start passing a null for gp.  For this
-           case, slk_start uses the number of groups ng (3 for the 3-2-3  lay-
-           out, 2 for the 4-4 layout) which slk_init provided.
+           case, slk_start uses the number of  groups  ng  (3  for  the  3-2-3
+           layout, 2 for the 4-4 layout) which slk_init provided.
 
-           If  ng  is  neither  2 or 3, slk_start checks the terminfo fln (la-
-           bel_format) capability, interpreting that as a comma-separated list
-           of numbers, e.g., "3,2,3" for the 3-2-3 layout.
+           If  ng  is  neither  2  or  3,  slk_start  checks  the terminfo fln
+           (label_format) capability, interpreting that as  a  comma-separated
+           list of numbers, e.g., "3,2,3" for the 3-2-3 layout.
 
            Finally, if there is no fln capability, slk_start returns ERR.
 
@@ -309,7 +311,7 @@
 
 
 
-ncurses 6.4                       2023-07-01                      curs_slk(3x)
+ncurses 6.4                       2023-09-16                      curs_slk(3x)

curs_sp_funcs 3x 2023-08-19 ncurses 6.4 Library calls

curs_sp_funcs 3x 2023-09-16 ncurses 6.4 Library calls

curs_sp_funcs 3x 2023-08-19 ncurses 6.4 Library calls

curs_sp_funcs 3x 2023-09-16 ncurses 6.4 Library calls

 curs_sp_funcs(3x)                Library calls               curs_sp_funcs(3x)
 
@@ -50,7 +50,7 @@

NAME

-       curs_sp_funcs - curses screen-pointer extension
+       curs_sp_funcs - curses screen-pointer extension

SYNOPSIS

@@ -229,14 +229,14 @@

IMPROVED FUNCTIONS

-       Most of the functions are new versions of existing functions.  A param-
-       eter  is  added  at  the  front  of the parameter list.  It is a SCREEN
+       Most of the functions  are  new  versions  of  existing  functions.   A
+       parameter  is added at the front of the parameter list.  It is a SCREEN
        pointer.
 
        The existing functions all use the current screen, which  is  a  static
-       variable.  The extended functions use the specified screen, thereby re-
-       ducing the number of variables which must be modified to update  multi-
-       ple screens.
+       variable.   The  extended  functions  use the specified screen, thereby
+       reducing the number of variables  which  must  be  modified  to  update
+       multiple screens.

NEW FUNCTIONS

@@ -254,8 +254,8 @@
             With  the  screen-pointer extension, there are situations where it
             must create a current screen before the unextended  library  does.
             The  new_prescr function is used internally to handle these cases.
-            It is also provided as an entrypoint to allow applications to cus-
-            tomize the library initialization.
+            It is also provided as an  entrypoint  to  allow  applications  to
+            customize the library initialization.

NOTES

@@ -268,27 +268,28 @@
 
        NCURSES_SP_NAME
             The new functions are named using the macro NCURSES_SP_NAME, which
-            hides the actual implementation.  Currently this adds a "_sp" suf-
-            fix  to the name of the unextended function.  This manual page in-
-            dexes the extensions showing the full name.   However  the  proper
-            usage of these functions uses the macro, to provide for the possi-
-            bility of changing the naming convention for specific library con-
-            figurations.
+            hides the actual implementation.   Currently  this  adds  a  "_sp"
+            suffix  to  the name of the unextended function.  This manual page
+            indexes the extensions showing the full name.  However the  proper
+            usage  of  these  functions  uses  the  macro,  to provide for the
+            possibility of changing the naming convention for specific library
+            configurations.
 
        NCURSES_SP_OUTC
             This  is  a new function-pointer type to use in the screen-pointer
             functions where an NCURSES_OUTC is used in the unextended library.
 
        NCURSES_OUTC
-            This is a function-pointer type used for the cases where  a  func-
-            tion passes characters to the output stream, e.g., vidputs(3x).
+            This is a  function-pointer  type  used  for  the  cases  where  a
+            function   passes   characters   to   the   output  stream,  e.g.,
+            vidputs(3x).

PORTABILITY

-       These  routines  are  specific  to ncurses.  They were not supported on
+       These routines are specific to ncurses.  They  were  not  supported  on
        Version 7, BSD or System V implementations.  It is recommended that any
-       code  depending  on  ncurses  extensions  be  conditioned  using NCURS-
-       ES_SP_FUNCS.
+       code   depending   on   ncurses   extensions   be   conditioned   using
+       NCURSES_SP_FUNCS.

curs_termattrs 3x 2023-07-01 ncurses 6.4 Library calls

curs_termattrs 3x 2023-09-16 ncurses 6.4 Library calls

 curs_termattrs(3x)               Library calls              curs_termattrs(3x)
 
@@ -48,7 +48,7 @@

NAME

        baudrate,  erasechar,  erasewchar, has_ic, has_il, killchar, killwchar,
-       longname, term_attrs, termattrs, termname -  curses  environment  query
+       longname, term_attrs, termattrs, termname -  curses  environment  query
        routines
 
 
@@ -149,7 +149,7 @@
 
 
 
-ncurses 6.4                       2023-07-01                curs_termattrs(3x)
+ncurses 6.4                       2023-09-16                curs_termattrs(3x)

curs_termcap 3x 2023-07-01 ncurses 6.4 Library calls

curs_termcap 3x 2023-09-16 ncurses 6.4 Library calls

curs_termcap 3x 2023-07-01 ncurses 6.4 Library calls

curs_termcap 3x 2023-09-16 ncurses 6.4 Library calls

 curs_termcap(3x)                 Library calls                curs_termcap(3x)
 
@@ -48,7 +48,7 @@

NAME

        PC, UP, BC, ospeed, tgetent, tgetflag, tgetnum, tgetstr, tgoto, tputs -
-       curses emulation of termcap
+       curses emulation of termcap

SYNOPSIS

@@ -88,16 +88,16 @@
 
        This differs from the termcap library in two ways:
 
-          o   The  emulation  ignores  the buffer pointer bp.  The termcap li-
-              brary would store a copy of the terminal description in the area
-              referenced  by this pointer.  However, ncurses stores its termi-
-              nal descriptions in compiled binary form, which is not the  same
-              thing.
+          o   The  emulation  ignores  the  buffer  pointer  bp.   The termcap
+              library would store a copy of the terminal  description  in  the
+              area  referenced  by  this pointer.  However, ncurses stores its
+              terminal descriptions in compiled binary form, which is not  the
+              same thing.
 
           o   There is a difference in return codes.  The termcap library does
               not check if the terminal description is marked with the generic
-              capability,  or  if the terminal description has cursor-address-
-              ing.
+              capability,   or   if   the  terminal  description  has  cursor-
+              addressing.

Capability Values

@@ -108,22 +108,22 @@
        available.
 
        The tgetstr routine returns the string entry for id, or zero if  it  is
-       not  available.  Use tputs to output the returned string.  The area pa-
-       rameter is used as follows:
+       not  available.   Use  tputs  to  output the returned string.  The area
+       parameter is used as follows:
 
           o   It is assumed to be the address of a pointer to a buffer managed
               by the calling application.
 
-          o   However, ncurses checks to ensure that area is not NULL, and al-
-              so that the resulting buffer pointer is  not  NULL.   If  either
+          o   However,  ncurses  checks  to  ensure that area is not NULL, and
+              also that the resulting buffer pointer is not NULL.   If  either
               check fails, the area parameter is ignored.
 
           o   If  the  checks succeed, ncurses also copies the return value to
-              the buffer pointed to by area, and the area value will be updat-
-              ed to point past the null ending this value.
+              the buffer pointed to by  area,  and  the  area  value  will  be
+              updated to point past the null ending this value.
 
-          o   The  return  value itself is an address in the terminal descrip-
-              tion which is loaded into memory.
+          o   The   return   value  itself  is  an  address  in  the  terminal
+              description which is loaded into memory.
 
        Only the first two characters of the id parameter of tgetflag,  tgetnum
        and tgetstr are compared in lookups.
@@ -133,30 +133,30 @@
        The tgoto routine expands the given capability using the parameters.
 
        o   Because  the  capability may have padding characters, the output of
-           tgoto should be passed to tputs rather than some other output func-
-           tion such as printf(3).
+           tgoto should be passed to  tputs  rather  than  some  other  output
+           function such as printf(3).
 
-       o   While  tgoto is assumed to be used for the two-parameter cursor po-
-           sitioning capability, termcap applications also use it for  single-
-           parameter capabilities.
+       o   While  tgoto  is  assumed  to  be used for the two-parameter cursor
+           positioning  capability,  termcap  applications  also  use  it  for
+           single-parameter capabilities.
 
-           Doing this shows a quirk in tgoto: most hardware terminals use cur-
-           sor addressing with row first, but the original developers  of  the
-           termcap  interface  chose  to  put the column parameter first.  The
+           Doing  this  shows  a  quirk  in tgoto: most hardware terminals use
+           cursor addressing with row first, but the  original  developers  of
+           the termcap interface chose to put the column parameter first.  The
            tgoto function swaps the order of parameters.  It  does  this  also
            for  calls  requiring  only  a single parameter.  In that case, the
            first parameter is merely a placeholder.
 
        o   Normally the ncurses library is compiled with terminfo support.  In
-           that  case, tgoto uses an internal version of tparm(3x) (a more ca-
-           pable formatter).
+           that  case,  tgoto  uses  an  internal version of tparm(3x) (a more
+           capable formatter).
 
            With terminfo support, tgoto is able to use some  of  the  terminfo
-           features,  but  not all.  In particular, it allows only numeric pa-
-           rameters; tparm supports string parameters.
+           features,  but  not  all.   In  particular,  it allows only numeric
+           parameters; tparm supports string parameters.
 
-           However, tparm is not a termcap feature, and portable  termcap  ap-
-           plications should not rely upon its availability.
+           However, tparm is not  a  termcap  feature,  and  portable  termcap
+           applications should not rely upon its availability.
 
        The  tputs  routine  is described on the curs_terminfo(3x) manual page.
        It can retrieve capabilities by either termcap or terminfo name.
@@ -173,24 +173,24 @@

Releasing Memory

        The termcap functions provide no  means  for  freeing  memory,  because
        legacy  termcap  implementations used only the buffer areas provided by
-       the caller via tgetent and tgetstr.  Those buffers are unused  in  ter-
-       minfo.
+       the caller via tgetent  and  tgetstr.   Those  buffers  are  unused  in
+       terminfo.
 
-       On the other hand, terminfo allocates memory.  It uses setupterm to re-
-       trieve the data used by tgetent and the functions which return capabil-
-       ity values such as tgetstr.  One could use
+       On  the  other  hand,  terminfo allocates memory.  It uses setupterm to
+       retrieve the data used  by  tgetent  and  the  functions  which  return
+       capability values such as tgetstr.  One could use
 
                del_curterm(cur_term);
 
 
        to  free  this  memory,  but  there  is an additional complication with
-       ncurses.  It uses a fixed-size pool of storage locations, one per  set-
-       ting  of  the TERM variable when tgetent is called.  The screen(1) pro-
-       gram relies upon this arrangement, to improve its performance.
+       ncurses.  It uses a fixed-size  pool  of  storage  locations,  one  per
+       setting  of  the  TERM  variable when tgetent is called.  The screen(1)
+       program relies upon this arrangement, to improve its performance.
 
        An application which uses only the low-level  termcap  functions  could
-       free the memory using del_curterm, because the pool is freed using oth-
-       er functions (see curs_memleaks(3x)).
+       free  the  memory  using  del_curterm,  because the pool is freed using
+       other functions (see curs_memleaks(3x)).

RETURN VALUE

@@ -208,8 +208,8 @@
        o   The  calls  with  a  string  parameter  (tgoto, tputs) check if the
            string is null, or cancelled.  Those return an error.
 
-       o   A call to tgoto using a capability with string parameters is an er-
-           ror.
+       o   A call to tgoto using a capability with  string  parameters  is  an
+           error.
 
        o   A call to tgoto using a capability with more than two parameters is
            an error.
@@ -220,13 +220,13 @@
        aware  that it will be returned in terminfo notation, not the older and
        not-quite-compatible termcap notation.  This will not cause problems if
        all  you do with it is call tgoto or tparm, which both expand terminfo-
-       style strings as terminfo.  (The tgoto function, if configured to  sup-
-       port  termcap,  will  check  if  the string is indeed terminfo-style by
+       style strings as terminfo.   (The  tgoto  function,  if  configured  to
+       support  termcap,  will check if the string is indeed terminfo-style by
        looking for "%p" parameters or "$<..>" delays, and  invoke  a  termcap-
        style parser if the string does not appear to be terminfo).
 
-       Because  terminfo  conventions for representing padding in string capa-
-       bilities differ from termcap's, users can be surprised:
+       Because   terminfo  conventions  for  representing  padding  in  string
+       capabilities differ from termcap's, users can be surprised:
 
        o   tputs("50") in a terminfo system will put out a literal "50" rather
            than busy-waiting for 50 milliseconds.
@@ -234,8 +234,8 @@
        o   However,  if  ncurses is configured to support termcap, it may also
            have been configured to support the BSD-style padding.
 
-           In that case, tputs inspects strings passed to it, looking for dig-
-           its at the beginning of the string.
+           In that case, tputs inspects strings  passed  to  it,  looking  for
+           digits at the beginning of the string.
 
            tputs("50") in a termcap system may wait for 50 milliseconds rather
            than put out a literal "50"
@@ -243,8 +243,8 @@
        Note that termcap has nothing analogous to terminfo's sgr string.   One
        consequence  of  this  is that termcap applications assume me (terminfo
        sgr0) does not reset the alternate character set.  This  implementation
-       checks for, and modifies the data shown to the termcap interface to ac-
-       commodate termcap's limitation in this respect.
+       checks  for,  and  modifies  the data shown to the termcap interface to
+       accommodate termcap's limitation in this respect.

PORTABILITY

@@ -253,46 +253,46 @@
        These functions are provided for supporting  legacy  applications,  and
        should not be used in new programs:
 
-       o   The XSI Curses standard, Issue 4 describes these functions.  Howev-
-           er, they are marked TO BE WITHDRAWN and may be  removed  in  future
-           versions.
+       o   The  XSI  Curses  standard,  Issue  4  describes  these  functions.
+           However, they are marked TO BE WITHDRAWN  and  may  be  removed  in
+           future versions.
 
        o   X/Open Curses, Issue 5 (December 2007) marked the termcap interface
            (along with vwprintw and vwscanw) as withdrawn.
 
        Neither the XSI Curses standard nor the SVr4 man pages  documented  the
-       return  values  of tgetent correctly, though all three were in fact re-
-       turned ever since SVr1.  In particular, an omission in the  XSI  Curses
+       return  values  of  tgetent  correctly,  though  all three were in fact
+       returned ever since SVr1.  In particular, an omission in the XSI Curses
        documentation  has  been misinterpreted to mean that tgetent returns OK
-       or ERR.  Because the purpose of these functions is to provide  compati-
-       bility  with the termcap library, that is a defect in XCurses, Issue 4,
-       Version 2 rather than in ncurses.
+       or  ERR.   Because  the  purpose  of  these  functions  is  to  provide
+       compatibility  with  the  termcap library, that is a defect in XCurses,
+       Issue 4, Version 2 rather than in ncurses.

Compatibility with BSD Termcap

-       External variables are provided for support of certain termcap applica-
-       tions.  However, termcap applications' use of those variables is poorly
-       documented, e.g., not distinguishing between input and output.  In par-
-       ticular,  some  applications  are reported to declare and/or modify os-
-       peed.
+       External  variables  are  provided  for  support  of  certain   termcap
+       applications.  However, termcap applications' use of those variables is
+       poorly documented, e.g., not distinguishing between input  and  output.
+       In  particular, some applications are reported to declare and/or modify
+       ospeed.
 
        The comment that only the first two characters of the id parameter  are
        used escapes many application developers.  The original BSD 4.2 termcap
        library (and historical relics thereof) did not require a trailing null
        NUL  on  the  parameter  name  passed to tgetstr, tgetnum and tgetflag.
        Some applications assume that the termcap interface  does  not  require
-       the trailing NUL for the parameter name.  Taking into account these is-
-       sues:
+       the  trailing  NUL  for  the parameter name.  Taking into account these
+       issues:
 
        o   As a special case,  tgetflag  matched  against  a  single-character
-           identifier  provided  that  was at the end of the terminal descrip-
-           tion.  You should not rely upon this behavior in portable programs.
-           This  implementation disallows matches against single-character ca-
-           pability names.
+           identifier   provided   that   was  at  the  end  of  the  terminal
+           description.  You should not rely upon this  behavior  in  portable
+           programs.   This  implementation  disallows matches against single-
+           character capability names.
 
        o   This implementation disallows  matches  by  the  termcap  interface
-           against extended capability names which are longer than two charac-
-           ters.
+           against  extended  capability  names  which  are  longer  than  two
+           characters.
 
        The BSD termcap function tgetent returns the text of a termcap entry in
        the  buffer  passed  as an argument.  This library (like other terminfo
@@ -302,8 +302,8 @@

Other Compatibility

        This  library includes a termcap.h header, for compatibility with other
-       implementations.  But the header is rarely used because the  other  im-
-       plementations are not strictly compatible.
+       implementations.  But the header  is  rarely  used  because  the  other
+       implementations are not strictly compatible.
 
        The original BSD termcap (through 4.3BSD) had no header file which gave
        function prototypes, because that was a feature of ANSI C.  BSD termcap
@@ -314,11 +314,11 @@
            It defined global symbols for the termcap variables which it used.
 
        o   The  other  appeared in 4.4BSD Lite Release 2 (mid-1993) as part of
-           libedit (also known as the editline library).  The CSRG source his-
-           tory  shows  that  this  was added in mid-1992.  The libedit header
-           file was used internally, as a convenience for compiling the  edit-
-           line library.  It declared function prototypes, but no global vari-
-           ables.
+           libedit (also known as the  editline  library).   The  CSRG  source
+           history  shows that this was added in mid-1992.  The libedit header
+           file was used  internally,  as  a  convenience  for  compiling  the
+           editline  library.   It declared function prototypes, but no global
+           variables.
 
        The header file from libedit was added to NetBSD's termcap  library  in
        mid-1994.
@@ -326,10 +326,10 @@
        Meanwhile,  GNU  termcap  was under development, starting in 1990.  The
        first release (termcap 1.0) in 1991 included a termcap.h  header.   The
        second  release  (termcap 1.1) in September 1992 modified the header to
-       use const for the function prototypes in the header where one would ex-
-       pect  the parameters to be read-only.  This was a difference versus the
-       original BSD termcap.  The prototype for tputs also  differed,  but  in
-       that instance, it was libedit which differed from BSD termcap.
+       use const for the function prototypes in the  header  where  one  would
+       expect  the  parameters  to be read-only.  This was a difference versus
+       the original BSD termcap.  The prototype for tputs also  differed,  but
+       in that instance, it was libedit which differed from BSD termcap.
 
        A copy of GNU termcap 1.3 was bundled with bash in mid-1993, to support
        the readline(3) library.
@@ -356,7 +356,7 @@
 
 
 
-ncurses 6.4                       2023-07-01                  curs_termcap(3x)
+ncurses 6.4                       2023-09-16                  curs_termcap(3x)

curs_terminfo 3x 2023-08-19 ncurses 6.4 Library calls

curs_terminfo 3x 2023-09-16 ncurses 6.4 Library calls

curs_terminfo 3x 2023-08-19 ncurses 6.4 Library calls

curs_terminfo 3x 2023-09-16 ncurses 6.4 Library calls

 curs_terminfo(3x)                Library calls               curs_terminfo(3x)
 
@@ -57,10 +57,10 @@

NAME

-       del_curterm, mvcur, putp, restartterm, set_curterm, setupterm,
-       tigetflag, tigetnum, tigetstr, tiparm, tiparm_s, tiscan_s, tparm,
-       tputs, vid_attr, vid_puts, vidattr, vidputs - curses interfaces to
-       terminfo database
+       del_curterm,   mvcur,   putp,   restartterm,   set_curterm,  setupterm,
+       tigetflag,  tigetnum,  tigetstr,  tiparm,  tiparm_s,  tiscan_s,  tparm,
+       tputs,  vid_attr,  vid_puts,  vidattr,  vidputs  - curses interfaces to
+       terminfo database

SYNOPSIS

@@ -111,45 +111,46 @@

DESCRIPTION

        These low-level routines must be called by programs that have  to  deal
-       directly with the terminfo database to handle certain terminal capabil-
-       ities, such as programming function keys.  For all other functionality,
-       curses routines are more suitable and their use is recommended.
+       directly   with  the  terminfo  database  to  handle  certain  terminal
+       capabilities,  such  as  programming  function  keys.   For  all  other
+       functionality,  curses  routines  are  more  suitable  and their use is
+       recommended.
 
-       None  of  these  functions  use  (or  are aware of) multibyte character
+       None of these functions use  (or  are  aware  of)  multibyte  character
        strings such as UTF-8:
 
        o   capability names use the POSIX portable character set
 
-       o   capability string values have  no  associated  encoding;  they  are
+       o   capability  string  values  have  no  associated encoding; they are
            strings of 8-bit characters.

Initialization

        Initially, setupterm should be called.  The high-level curses functions
-       initscr and newterm call setupterm to initialize the low-level  set  of
+       initscr  and  newterm call setupterm to initialize the low-level set of
        terminal-dependent variables [listed in terminfo(5)].
 
-       Applications  can  use  the  terminal capabilities either directly (via
-       header definitions), or by special functions.  The header  files  curs-
-       es.h  and  term.h should be included (in this order) to get the defini-
-       tions for these strings, numbers, and flags.
+       Applications can use the terminal  capabilities  either  directly  (via
+       header  definitions),  or  by  special  functions.   The  header  files
+       curses.h and term.h should be included  (in  this  order)  to  get  the
+       definitions for these strings, numbers, and flags.
 
-       The terminfo variables lines and columns are initialized  by  setupterm
+       The  terminfo  variables lines and columns are initialized by setupterm
        as follows:
 
-       o   If  use_env(FALSE)  has  been  called, values for lines and columns
+       o   If use_env(FALSE) has been called, values  for  lines  and  columns
            specified in terminfo are used.
 
-       o   Otherwise, if the environment variables LINES  and  COLUMNS  exist,
+       o   Otherwise,  if  the  environment variables LINES and COLUMNS exist,
            their values are used.  If these environment variables do not exist
-           and the program is running in a window, the current window size  is
-           used.   Otherwise,  if  the environment variables do not exist, the
+           and  the program is running in a window, the current window size is
+           used.  Otherwise, if the environment variables do  not  exist,  the
            values for lines and columns specified in the terminfo database are
            used.
 
-       Parameterized  strings  should  be  passed through tparm to instantiate
-       them.  All terminfo strings (including the output of tparm)  should  be
-       printed  with  tputs or putp.  Call reset_shell_mode to restore the tty
+       Parameterized strings should be passed  through  tparm  to  instantiate
+       them.   All  terminfo strings (including the output of tparm) should be
+       printed with tputs or putp.  Call reset_shell_mode to restore  the  tty
        modes before exiting [see curs_kernel(3x)].
 
        Programs which use cursor addressing should
@@ -160,55 +161,55 @@
 
        Programs which execute shell subprocesses should
 
-       o   call reset_shell_mode and output exit_ca_mode before the  shell  is
+       o   call  reset_shell_mode  and output exit_ca_mode before the shell is
            called and
 
-       o   output  enter_ca_mode and call reset_prog_mode after returning from
+       o   output enter_ca_mode and call reset_prog_mode after returning  from
            the shell.
 
-       The setupterm routine reads in the terminfo database, initializing  the
-       terminfo  structures,  but  does  not  set up the output virtualization
+       The  setupterm routine reads in the terminfo database, initializing the
+       terminfo structures, but does not  set  up  the  output  virtualization
        structures used by curses.  These are its parameters:
 
           term is the terminal type, a character string.  If term is null, the
                environment variable TERM is used.
 
           filedes
-               is  the  file  descriptor used for getting and setting terminal
+               is the file descriptor used for getting  and  setting  terminal
                I/O modes.
 
-               Higher-level applications use newterm(3x) for initializing  the
-               terminal,  passing  an  output stream rather than a descriptor.
-               In curses, the two are  the  same  because  newterm  calls  se-
-               tupterm,  passing  the  file descriptor derived from its output
+               Higher-level  applications use newterm(3x) for initializing the
+               terminal, passing an output stream rather  than  a  descriptor.
+               In   curses,  the  two  are  the  same  because  newterm  calls
+               setupterm, passing the file descriptor derived from its  output
                stream parameter.
 
           errret
-               points to an optional location where an error status can be re-
-               turned  to  the  caller.  If errret is not null, then setupterm
-               returns OK or ERR and stores a  status  value  in  the  integer
-               pointed  to by errret.  A return value of OK combined with sta-
-               tus of 1 in errret is normal.
+               points  to  an  optional  location where an error status can be
+               returned to the caller.  If errret is not null, then  setupterm
+               returns  OK  or  ERR  and  stores a status value in the integer
+               pointed to by errret.  A  return  value  of  OK  combined  with
+               status of 1 in errret is normal.
 
                If ERR is returned, examine errret:
 
-               1    means that the terminal is hardcopy, cannot  be  used  for
+               1    means  that  the  terminal is hardcopy, cannot be used for
                     curses applications.
 
-                    setupterm  determines  if  the entry is a hardcopy type by
+                    setupterm determines if the entry is a  hardcopy  type  by
                     checking the hc (hardcopy) capability.
 
-               0    means that the terminal could not be found, or that it  is
-                    a  generic  type, having too little information for curses
+               0    means  that the terminal could not be found, or that it is
+                    a generic type, having too little information  for  curses
                     applications to run.
 
-                    setupterm determines if the entry is  a  generic  type  by
+                    setupterm  determines  if  the  entry is a generic type by
                     checking the gn (generic_type) capability.
 
                -1   means that the terminfo database could not be found.
 
-               If errret is null, setupterm prints an error message upon find-
-               ing an error and exits.  Thus, the simplest call is:
+               If errret is null,  setupterm  prints  an  error  message  upon
+               finding an error and exits.  Thus, the simplest call is:
 
                      setupterm((char *)0, 1, (int *)0);,
 
@@ -216,122 +217,122 @@

The Terminal State

-       The setupterm routine stores its information about the  terminal  in  a
-       TERMINAL  structure  pointed to by the global variable cur_term.  If it
-       detects an error, or decides that the terminal is unsuitable  (hardcopy
-       or  generic),  it discards this information, making it not available to
+       The  setupterm  routine  stores its information about the terminal in a
+       TERMINAL structure pointed to by the global variable cur_term.   If  it
+       detects  an error, or decides that the terminal is unsuitable (hardcopy
+       or generic), it discards this information, making it not  available  to
        applications.
 
-       If setupterm is called repeatedly for the same terminal type,  it  will
-       reuse  the  information.   It maintains only one copy of a given termi-
-       nal's capabilities in memory.  If it is called for  different  terminal
-       types,  setupterm  allocates new storage for each set of terminal capa-
-       bilities.
+       If  setupterm  is called repeatedly for the same terminal type, it will
+       reuse  the  information.   It  maintains  only  one  copy  of  a  given
+       terminal's  capabilities  in  memory.   If  it  is called for different
+       terminal types,  setupterm  allocates  new  storage  for  each  set  of
+       terminal capabilities.
 
-       The set_curterm routine sets cur_term to nterm, and makes  all  of  the
-       terminfo  boolean,  numeric,  and  string variables use the values from
+       The  set_curterm  routine  sets cur_term to nterm, and makes all of the
+       terminfo boolean, numeric, and string variables  use  the  values  from
        nterm.  It returns the old value of cur_term.
 
-       The del_curterm routine frees the space pointed to by oterm  and  makes
-       it available for further use.  If oterm is the same as cur_term, refer-
-       ences to any of the terminfo boolean,  numeric,  and  string  variables
-       thereafter  may  refer  to  invalid  memory locations until another se-
-       tupterm has been called.
+       The  del_curterm  routine frees the space pointed to by oterm and makes
+       it available for further use.   If  oterm  is  the  same  as  cur_term,
+       references  to  any  of  the  terminfo  boolean,  numeric,  and  string
+       variables thereafter  may  refer  to  invalid  memory  locations  until
+       another setupterm has been called.
 
-       The restartterm routine is similar to  setupterm  and  initscr,  except
-       that it is called after restoring memory to a previous state (for exam-
-       ple, when reloading a game saved as a core  image  dump).   restartterm
-       assumes  that the windows and the input and output options are the same
-       as when memory was saved, but the terminal type and baud  rate  may  be
-       different.   Accordingly,  restartterm  saves  various  tty state bits,
-       calls setupterm, and then restores the bits.
+       The  restartterm  routine  is  similar to setupterm and initscr, except
+       that it is called after restoring  memory  to  a  previous  state  (for
+       example,   when   reloading  a  game  saved  as  a  core  image  dump).
+       restartterm assumes that the windows and the input and  output  options
+       are  the  same as when memory was saved, but the terminal type and baud
+       rate may be different.   Accordingly,  restartterm  saves  various  tty
+       state bits, calls setupterm, and then restores the bits.

Formatting Output

-       The tparm routine instantiates the string str with  parameters  pi.   A
-       pointer  is  returned to the result of str with the parameters applied.
-       Application developers should keep in mind these quirks of  the  inter-
-       face:
+       The  tparm  routine  instantiates the string str with parameters pi.  A
+       pointer is returned to the result of str with the  parameters  applied.
+       Application  developers  should  keep  in  mind  these  quirks  of  the
+       interface:
 
-       o   Although  tparm's actual parameters may be integers or strings, the
+       o   Although tparm's actual parameters may be integers or strings,  the
            prototype expects long (integer) values.
 
-       o   Aside from the set_attributes (sgr) capability, most terminal capa-
-           bilities require no more than one or two parameters.
+       o   Aside  from  the  set_attributes  (sgr)  capability,  most terminal
+           capabilities require no more than one or two parameters.
 
-       o   Padding  information  is  ignored  by  tparm;  it is interpreted by
+       o   Padding information is ignored  by  tparm;  it  is  interpreted  by
            tputs.
 
-       o   The capability string is  null-terminated.   Use  "\200"  where  an
+       o   The  capability  string  is  null-terminated.   Use "\200" where an
            ASCII NUL is needed in the output.
 
-       tiparm  is  a  newer  form of tparm which uses <stdarg.h> rather than a
+       tiparm is a newer form of tparm which uses  <stdarg.h>  rather  than  a
        fixed-parameter list.  Its numeric parameters are integers (int) rather
        than longs.
 
-       Both  tparm  and  tiparm  assume that the application passes parameters
-       consistent with the terminal description.  Two extensions are  provided
+       Both tparm and tiparm assume that  the  application  passes  parameters
+       consistent  with the terminal description.  Two extensions are provided
        as alternatives to deal with untrusted data:
 
-       o   tiparm_s  is an extension which is a safer formatting function than
+       o   tiparm_s is an extension which is a safer formatting function  than
            tparm or tiparm, because it allows the developer to tell the curses
-           library  how  many  parameters to expect in the parameter list, and
+           library how many parameters to expect in the  parameter  list,  and
            which may be string parameters.
 
-           The mask parameter has one bit set for each of the  parameters  (up
+           The  mask  parameter has one bit set for each of the parameters (up
            to 9) which will be passed as char* rather than numbers.
 
-       o   The  extension tiscan_s allows the application to inspect a format-
-           ting capability to see what the curses library would assume.
+       o   The  extension  tiscan_s  allows  the  application  to  inspect   a
+           formatting capability to see what the curses library would assume.

Output Functions

-       The tputs routine applies padding information  (i.e.,  by  interpreting
-       marker  embedded  in  the  terminfo capability such as "$<5>" as 5 mil-
-       liseconds) to the string str and outputs it:
+       The  tputs  routine  applies padding information (i.e., by interpreting
+       marker embedded  in  the  terminfo  capability  such  as  "$<5>"  as  5
+       milliseconds) to the string str and outputs it:
 
-       o   The str parameter must be a terminfo string variable or the  return
+       o   The  str parameter must be a terminfo string variable or the return
            value from tparm, tiparm, tgetstr, or tgoto.
 
-           The  tgetstr and tgoto functions are part of the termcap interface,
-           which happens to share this function name with the terminfo  inter-
-           face.
+           The tgetstr and tgoto functions are part of the termcap  interface,
+           which  happens  to  share  this  function  name  with  the terminfo
+           interface.
 
        o   affcnt is the number of lines affected, or 1 if not applicable.
 
-       o   putc  is a putchar-like routine to which the characters are passed,
+       o   putc is a putchar-like routine to which the characters are  passed,
            one at a time.
 
-       The putp routine calls tputs(str, 1, putchar).  The output of putp  al-
-       ways goes to stdout, rather than the filedes specified in setupterm.
+       The  putp  routine  calls  tputs(str,  1, putchar).  The output of putp
+       always goes to stdout, rather than the filedes specified in setupterm.
 
-       The  vidputs  routine  displays the string on the terminal in the video
+       The vidputs routine displays the string on the terminal  in  the  video
        attribute mode attrs, which is any combination of the attributes listed
-       in  curses(3x).   The characters are passed to the putchar-like routine
+       in curses(3x).  The characters are passed to the  putchar-like  routine
        putc.
 
        The vidattr routine is like the vidputs routine, except that it outputs
        through putchar.
 
-       The  vid_attr  and vid_puts routines correspond to vidattr and vidputs,
-       respectively.  They use a set of arguments for representing  the  video
+       The vid_attr and vid_puts routines correspond to vidattr  and  vidputs,
+       respectively.   They  use a set of arguments for representing the video
        attributes plus color, i.e.,
 
        o   attrs of type attr_t for the attributes and
 
        o   pair of type short for the color-pair number.
 
-       The  vid_attr  and  vid_puts routines are designed to use the attribute
+       The vid_attr and vid_puts routines are designed to  use  the  attribute
        constants with the WA_ prefix.
 
-       X/Open Curses reserves the opts argument for future  use,  saying  that
-       applications  must provide a null pointer for that argument.  As an ex-
-       tension, this implementation allows opts to be used  as  a  pointer  to
+       X/Open  Curses  reserves  the opts argument for future use, saying that
+       applications must provide a null pointer  for  that  argument.   As  an
+       extension,  this  implementation allows opts to be used as a pointer to
        int, which overrides the pair (short) argument.
 
-       The  mvcur  routine  provides low-level cursor motion.  It takes effect
-       immediately (rather than at the next refresh).  Unlike the  other  low-
-       level  output  functions,  which either write to the standard output or
+       The mvcur routine provides low-level cursor motion.   It  takes  effect
+       immediately  (rather  than at the next refresh).  Unlike the other low-
+       level output functions, which either write to the  standard  output  or
        pass an output function parameter, mvcur uses an output file descriptor
        derived from the output stream parameter of newterm(3x).
 
@@ -341,9 +342,9 @@

Terminal Capability Functions

-       The  tigetflag,  tigetnum and tigetstr routines return the value of the
-       capability corresponding to the terminfo capname passed to  them,  such
-       as  xenl.  The capname for each capability is given in the table column
+       The tigetflag, tigetnum and tigetstr routines return the value  of  the
+       capability  corresponding  to the terminfo capname passed to them, such
+       as xenl.  The capname for each capability is given in the table  column
        entitled capname code in the capabilities section of terminfo(5).
 
        These routines return special values to denote errors.
@@ -386,33 +387,34 @@

Releasing Memory

        Each successful call to setupterm allocates memory to hold the terminal
-       description.  As a side-effect, it sets cur_term to point to this memo-
-       ry.  If an application calls
+       description.  As a side-effect, it  sets  cur_term  to  point  to  this
+       memory.  If an application calls
 
                del_curterm(cur_term);
 
        the memory will be freed.
 
-       The formatting functions tparm and tiparm extend the storage  allocated
+       The  formatting functions tparm and tiparm extend the storage allocated
        by setupterm:
 
-       o   the  "static"  terminfo variables [a-z].  Before ncurses 6.3, those
-           were shared by all screens.  With ncurses 6.3, those are  allocated
+       o   the "static" terminfo variables [a-z].  Before ncurses  6.3,  those
+           were  shared by all screens.  With ncurses 6.3, those are allocated
            per screen.  See terminfo(5) for details.
 
-       o   to  improve performance, ncurses 6.3 caches the result of analyzing
-           terminfo strings for their parameter types.  That is  stored  as  a
+       o   to improve performance, ncurses 6.3 caches the result of  analyzing
+           terminfo  strings  for  their parameter types.  That is stored as a
            binary tree referenced from the TERMINAL structure.
 
        The higher-level initscr and newterm functions use setupterm.  Normally
-       they do not free this memory, but it is possible to do that  using  the
+       they  do  not free this memory, but it is possible to do that using the
        delscreen(3x) function.

RETURN VALUE

-       Routines  that  return  an integer return ERR upon failure and OK (SVr4
-       only specifies "an integer value other than ERR") upon successful  com-
-       pletion, unless otherwise noted in the preceding routine descriptions.
+       Routines that return an integer return ERR upon failure  and  OK  (SVr4
+       only  specifies  "an  integer  value  other  than ERR") upon successful
+       completion,  unless  otherwise   noted   in   the   preceding   routine
+       descriptions.
 
        Routines that return pointers always return NULL on error.
 
@@ -429,13 +431,13 @@
 
           setupterm
                returns an error if it cannot allocate enough memory, or create
-               the initial windows (stdscr, curscr, newscr).  Other error con-
-               ditions are documented above.
+               the  initial  windows  (stdscr,  curscr,  newscr).  Other error
+               conditions are documented above.
 
           tparm
-               returns a null if the capability would require  unexpected  pa-
-               rameters,  e.g., too many, too few, or incorrect types (strings
-               where integers are expected, or vice versa).
+               returns a null  if  the  capability  would  require  unexpected
+               parameters,  e.g.,  too  many,  too  few,  or  incorrect  types
+               (strings where integers are expected, or vice versa).
 
           tputs
                returns an error if the string parameter is null.  It does  not
@@ -444,8 +446,8 @@

Compatibility macros

-       This implementation provides a few macros for compatibility  with  sys-
-       tems  before  SVr4  (see  HISTORY).   Those  include  crmode,  fixterm,
+       This implementation  provides  a  few  macros  for  compatibility  with
+       systems  before  SVr4  (see  HISTORY).   Those include crmode, fixterm,
        gettmode, nocrmode, resetterm, saveterm, and setterm.
 
        In SVr4, those are found in <curses.h>, but  except  for  setterm,  are
@@ -455,9 +457,9 @@
 
              setupterm(term, 1, (int *)0)
 
-       provides the same functionality as setterm(term), and is not recommend-
-       ed for new programs.  This implementation provides each of  those  sym-
-       bols as macros for BSD compatibility,
+       provides   the   same   functionality  as  setterm(term),  and  is  not
+       recommended for new programs.  This  implementation  provides  each  of
+       those symbols as macros for BSD compatibility,

HISTORY

@@ -467,10 +469,11 @@
        Function    Description
        ------------------------------------------------------------
        fixterm     restore tty to "in curses" state
+
        gettmode    establish current tty modes
        mvcur       low level cursor motion
-       putp        utility function that uses tputs to send  char-
-                   acters via putchar.
+       putp        utility  function  that  uses  tputs  to   send
+                   characters via putchar.
        resetterm   set tty modes to "out of curses" state
        resetty     reset tty flags to stored value
        saveterm    save current modes as "in curses" state
@@ -499,8 +502,8 @@
        Early terminfo programs obtained capability values  from  the  TERMINAL
        structure initialized by setupterm.
 
-       SVr3  extended terminfo by adding functions to retrieve capability val-
-       ues (like the termcap interface), and reusing tgoto and tputs:
+       SVr3  extended  terminfo  by  adding  functions  to retrieve capability
+       values (like the termcap interface), and reusing tgoto and tputs:
 
        Function    Description
        -------------------------------------------
@@ -522,13 +525,13 @@
        setterm     setupterm
 
        SVr3  kept  the  mvcur, vidattr and vidputs functions, along with putp,
-       tparm and tputs.  The latter were needed to support padding,  and  han-
-       dling  functions  such as vidattr (which used more than the two parame-
-       ters supported by tgoto).
+       tparm and tputs.  The  latter  were  needed  to  support  padding,  and
+       handling  functions  such  as  vidattr  (which  used  more than the two
+       parameters supported by tgoto).
 
-       SVr3 introduced the functions for switching between  terminal  descrip-
-       tions, e.g., set_curterm.  Some of that was incremental improvements to
-       the SVr2 library:
+       SVr3  introduced  the  functions   for   switching   between   terminal
+       descriptions,   e.g.,   set_curterm.   Some  of  that  was  incremental
+       improvements to the SVr2 library:
 
        o   The TERMINAL type definition was introduced  in  SVr3.01,  for  the
            term structure provided in SVr2.
@@ -540,16 +543,16 @@
        SVr4 added the vid_attr and vid_puts functions.
 
        There are other low-level functions declared in the curses header files
-       on Unix systems, but none were documented.  The functions marked "obso-
-       lete" remained in use by the Unix vi(1) editor.
+       on Unix systems,  but  none  were  documented.   The  functions  marked
+       "obsolete" remained in use by the Unix vi(1) editor.

PORTABILITY

Extensions

        The  functions  marked as extensions were designed for ncurses(3x), and
-       are not found in SVr4 curses, 4.4BSD curses, or any other previous ver-
-       sion of curses.
+       are not found in SVr4 curses, 4.4BSD  curses,  or  any  other  previous
+       version of curses.

Legacy functions

@@ -573,22 +576,22 @@

Output buffering

        Older  versions  of  ncurses assumed that the file descriptor passed to
        setupterm from initscr or newterm uses buffered I/O, and would write to
-       the  corresponding stream.  In addition to the limitation that the ter-
-       minal was left in block-buffered mode on exit (like System  V  curses),
-       it  was  problematic  because  ncurses  did not allow a reliable way to
-       cleanup on receiving SIGTSTP.
+       the  corresponding  stream.   In  addition  to  the limitation that the
+       terminal was left  in  block-buffered  mode  on  exit  (like  System  V
+       curses),  it  was  problematic because ncurses did not allow a reliable
+       way to cleanup on receiving SIGTSTP.
 
        The current version (ncurses6) uses output buffers managed directly  by
        ncurses.  Some of the low-level functions described in this manual page
-       write to the standard output.  They are not signal-safe.  The high-lev-
-       el functions in ncurses use alternate versions of these functions using
-       the more reliable buffering scheme.
+       write to the standard output.  They are  not  signal-safe.   The  high-
+       level  functions  in  ncurses use alternate versions of these functions
+       using the more reliable buffering scheme.

Function prototypes

-       The X/Open Curses prototypes are based on the SVr4 curses header decla-
-       rations,  which  were defined at the same time the C language was first
-       standardized in the late 1980s.
+       The X/Open Curses prototypes  are  based  on  the  SVr4  curses  header
+       declarations,  which  were  defined at the same time the C language was
+       first standardized in the late 1980s.
 
        o   X/Open Curses uses const  less  effectively  than  a  later  design
            might,  in  some cases applying it needlessly to values are already
@@ -604,8 +607,8 @@
        o   X/Open  Curses  prototypes tparm with a fixed number of parameters,
            rather than a variable argument list.
 
-           This implementation uses a variable argument list, but can be  con-
-           figured  to  use  the  fixed-parameter list.  Portable applications
+           This implementation uses a  variable  argument  list,  but  can  be
+           configured  to use the fixed-parameter list.  Portable applications
            should provide 9 parameters after the format; zeroes are  fine  for
            this purpose.
 
@@ -622,23 +625,23 @@
            nine on each call is awkward.
 
            Using  long  for the numeric parameter type is a workaround to make
-           the parameter use the same amount of stack as a pointer.  That  ap-
-           proach  dates  back  to  the  mid-1980s, before C was standardized.
+           the parameter use the same amount of  stack  as  a  pointer.   That
+           approach  dates  back  to the mid-1980s, before C was standardized.
            Since then, there is a standard (and pointers are not  required  to
            fit in a long).
 
        o   Providing  the  right  number of parameters for a variadic function
-           such as tiparm can be a problem, in particular for  string  parame-
-           ters.  However, only a few terminfo capabilities use string parame-
-           ters (e.g., the ones used for programmable function keys).
+           such  as  tiparm  can  be  a  problem,  in  particular  for  string
+           parameters.   However,  only a few terminfo capabilities use string
+           parameters (e.g., the ones used for programmable function keys).
 
            The ncurses library checks usage of these capabilities, and returns
            an  error  if  the capability mishandles string parameters.  But it
            cannot check if a calling program provides  strings  in  the  right
            places for the tparm calls.
 
-           The tput(1) program checks its use of these capabilities with a ta-
-           ble, so that it calls tparm correctly.
+           The  tput(1)  program  checks  its use of these capabilities with a
+           table, so that it calls tparm correctly.

Special TERM treatment

@@ -670,26 +673,26 @@
        and does no error-checking.
 
        X/Open  notes  that after calling mvcur, the curses state may not match
-       the actual terminal state, and that an application should touch and re-
-       fresh the window before resuming normal curses calls.  Both ncurses and
-       System V Release 4 curses implement mvcur using the SCREEN  data  allo-
-       cated  in  either  initscr or newterm.  So though it is documented as a
-       terminfo function, mvcur is really a curses function which is not  well
-       specified.
-
-       X/Open  states that the old location must be given for mvcur.  This im-
-       plementation allows the caller to use -1's for the old  ordinates.   In
+       the actual terminal state, and that an  application  should  touch  and
+       refresh  the  window before resuming normal curses calls.  Both ncurses
+       and System V Release 4 curses implement mvcur  using  the  SCREEN  data
+       allocated  in either initscr or newterm.  So though it is documented as
+       a terminfo function, mvcur is really a curses  function  which  is  not
+       well specified.
+
+       X/Open  states  that  the  old  location must be given for mvcur.  This
+       implementation allows the caller to use -1's for the old ordinates.  In
        that case, the old location is unknown.

curs_threads 3x 2023-08-19 ncurses 6.4 Library calls

curs_threads 3x 2023-09-16 ncurses 6.4 Library calls

 curs_threads(3x)                 Library calls                curs_threads(3x)
 
@@ -50,7 +50,7 @@

NAME

-       curs_threads - curses thread support
+       curs_threads - curses thread support

SYNOPSIS

@@ -69,13 +69,13 @@

DESCRIPTION

        This  implementation  can  be configured to provide rudimentary support
-       for multi-threaded applications.  This makes a  different  set  of  li-
-       braries, e.g., libncursest since the binary interfaces are different.
+       for  multi-threaded  applications.   This  makes  a  different  set  of
+       libraries, e.g., libncursest since the binary interfaces are different.
 
        Rather  than  modify  the interfaces to pass a thread specifier to each
-       function, it adds a few functions which can be used in  any  configura-
-       tion  which  hide  the  mutex's needed to prevent concurrent use of the
-       global variables when configured for threading.
+       function,  it  adds  a  few  functions  which  can  be  used   in   any
+       configuration  which  hide the mutex's needed to prevent concurrent use
+       of the global variables when configured for threading.
 
        In addition to forcing access to members of the WINDOW structure to  be
        via  functions  (see curs_opaque(3x)), it makes functions of the common
@@ -90,33 +90,34 @@
        are considered writable by some applications.  The functions  described
        here address these special situations.
 
-       The ESCDELAY and TABSIZE global variables are modified by some applica-
-       tions.  To modify them in any configuration, use  the  set_escdelay  or
-       set_tabsize functions.  Other global variables are not modifiable.
+       The  ESCDELAY  and  TABSIZE  global  variables  are  modified  by  some
+       applications.   To  modify  them  in   any   configuration,   use   the
+       set_escdelay  or set_tabsize functions.  Other global variables are not
+       modifiable.
 
        The get_escdelay function returns the value for ESCDELAY.
 
-       The  use_window and use_screen functions provide coarse granularity mu-
-       texes for their respective WINDOW and SCREEN parameters, and call a us-
-       er-supplied  function,  passing  it a data parameter, and returning the
+       The use_window and  use_screen  functions  provide  coarse  granularity
+       mutexes  for  their respective WINDOW and SCREEN parameters, and call a
+       user-supplied function, passing it a data parameter, and returning  the
        value from the user-supplied function to the application.

USAGE

-       All of the ncurses library functions assume that the locale is not  al-
-       tered during operation.  In addition, they use data which is maintained
-       within a hierarchy of scopes.
+       All  of  the  ncurses  library  functions assume that the locale is not
+       altered  during  operation.   In  addition,  they  use  data  which  is
+       maintained within a hierarchy of scopes.
 
-          o   global data, e.g., used in the low-level terminfo or termcap in-
-              terfaces.
+          o   global  data,  e.g.,  used  in the low-level terminfo or termcap
+              interfaces.
 
           o   terminal data, e.g., associated with a call to set_curterm.  The
               terminal data are initialized when screens are created.
 
           o   screen data, e.g., associated with a call to newterm or initscr.
 
-          o   window data, e.g., associated with a call to newwin  or  subwin.
-              Windows  are  associated with screens.  Pads are not necessarily
+          o   window  data,  e.g., associated with a call to newwin or subwin.
+              Windows are associated with screens.  Pads are  not  necessarily
               associated with a particular screen.
 
               Most curses applications operate on one or more windows within a
@@ -124,7 +125,7 @@
 
           o   reentrant, i.e., it uses only the data passed as parameters.
 
-       This  table lists the scope of data used for each symbol in the ncurses
+       This table lists the scope of data used for each symbol in the  ncurses
        library when it is configured to support threading:
 
             Symbol                  Scope
@@ -178,10 +179,10 @@
             chgat                   window (stdscr)
             clear                   window (stdscr)
             clearok                 window
+
             clrtobot                window (stdscr)
             clrtoeol                window (stdscr)
             color_content           screen
-
             color_set               window (stdscr)
             copywin                 window locks(source, target)
             cur_term                terminal
@@ -244,11 +245,11 @@
             in_wchnstr              window (stdscr)
             in_wchstr               window (stdscr)
             inch                    window (stdscr)
+
             inchnstr                window (stdscr)
             inchstr                 window (stdscr)
             init_color              screen
             init_pair               screen
-
             initscr                 global locks(screenlist)
             innstr                  window (stdscr)
             innwstr                 window (stdscr)
@@ -310,12 +311,12 @@
             mvget_wch               screen (input-operation)
             mvget_wstr              screen (input-operation)
             mvgetch                 screen (input-operation)
+
             mvgetn_wstr             screen (input-operation)
             mvgetnstr               screen (input-operation)
             mvgetstr                screen (input-operation)
             mvhline                 window (stdscr)
             mvhline_set             window (stdscr)
-
             mvin_wch                window (stdscr)
             mvin_wchnstr            window (stdscr)
             mvin_wchstr             window (stdscr)
@@ -376,13 +377,13 @@
             mvwprintw               window
             mvwscanw                screen
             mvwvline                window
+
             mvwvline_set            window
             napms                   reentrant
             newpad                  global locks(windowlist)
             newscr                  screen (readonly)
             newterm                 global locks(screenlist)
             newwin                  global locks(windowlist)
-
             nl                      screen
             nocbreak                screen
             nodelay                 window
@@ -442,6 +443,7 @@
             slk_attrset             screen
             slk_clear               screen
             slk_color               screen
+
             slk_init                screen
             slk_label               screen
             slk_noutrefresh         screen
@@ -449,7 +451,6 @@
             slk_restore             screen
             slk_set                 screen
             slk_touch               screen
-
             slk_wset                screen
             standend                window
             standout                window
@@ -508,6 +509,7 @@
             waddchnstr              window
             waddchstr               window
             waddnstr                window
+
             waddnwstr               window
             waddstr                 window
             waddwstr                window
@@ -516,7 +518,6 @@
             wattr_on                window
             wattr_set               window
             wattroff                window
-
             wattron                 window
             wattrset                window
             wbkgd                   window
@@ -574,6 +575,7 @@
             wredrawln               window
             wrefresh                screen
             wresize                 window locks(windowlist)
+
             wscanw                  screen
             wscrl                   window
             wsetscrreg              window
@@ -583,7 +585,6 @@
             wsyncup                 screen (affects window plus parents)
             wtimeout                window
             wtouchln                window
-
             wunctrl                 global (static data)
             wvline                  window
             wvline_set              window
@@ -598,10 +599,10 @@

PORTABILITY

-       These routines are specific to ncurses.  They  were  not  supported  on
+       These  routines  are  specific  to ncurses.  They were not supported on
        Version 7, BSD or System V implementations.  It is recommended that any
-       code depending on ncurses extensions be conditioned using  NCURSES_VER-
-       SION.
+       code   depending   on   ncurses   extensions   be   conditioned   using
+       NCURSES_VERSION.

curs_touch 3x 2023-07-01 ncurses 6.4 Library calls

curs_touch 3x 2023-09-16 ncurses 6.4 Library calls

 curs_touch(3x)                   Library calls                  curs_touch(3x)
 
@@ -47,8 +47,8 @@

NAME

-       touchwin, touchline, untouchwin, wtouchln, is_linetouched,
-       is_wintouched - curses refresh control routines
+       touchwin,     touchline,    untouchwin,    wtouchln,    is_linetouched,
+       is_wintouched - control terminal output refresh in a curses window

SYNOPSIS

@@ -66,57 +66,58 @@

DESCRIPTION

-       The touchwin and touchline routines throw away all optimization  infor-
-       mation about which parts of the window have been touched, by pretending
-       that the entire window has been drawn on.  This is sometimes  necessary
-       when  using  overlapping  windows, since a change to one window affects
-       the other window, but the records of which lines have been  changed  in
-       the other window do not reflect the change.  The routine touchline only
-       pretends that count lines have been changed, beginning with line start.
+       The  touchwin  and  touchline  routines  throw  away  all  optimization
+       information  about  which  parts  of  the  window have been touched, by
+       pretending that the entire window has been drawn on.  This is sometimes
+       necessary  when using overlapping windows, since a change to one window
+       affects the other window, but the records  of  which  lines  have  been
+       changed  in  the  other  window do not reflect the change.  The routine
+       touchline only pretends that count lines have been  changed,  beginning
+       with line start.
 
        The untouchwin routine marks all lines in the window as unchanged since
        the last call to wrefresh.
 
-       The  wtouchln  routine makes n lines in the window, starting at line y,
-       look as if they have (changed=1) or have not (changed=0)  been  changed
+       The wtouchln routine makes n lines in the window, starting at  line  y,
+       look  as  if they have (changed=1) or have not (changed=0) been changed
        since the last call to wrefresh.
 
-       The is_linetouched and is_wintouched routines return TRUE if the speci-
-       fied line/window was modified since the last call to  wrefresh;  other-
-       wise  they  return  FALSE.   In addition, is_linetouched returns ERR if
-       line is not valid for the given window.
+       The is_linetouched  and  is_wintouched  routines  return  TRUE  if  the
+       specified  line/window  was  modified  since the last call to wrefresh;
+       otherwise they return FALSE.  In addition, is_linetouched  returns  ERR
+       if line is not valid for the given window.

RETURN VALUE

-       All routines return the integer ERR upon failure and an  integer  value
-       other  than  ERR  upon successful completion, unless otherwise noted in
+       All  routines  return the integer ERR upon failure and an integer value
+       other than ERR upon successful completion, unless  otherwise  noted  in
        the preceding routine descriptions.
 
        X/Open does not define any error conditions.  In this implementation
 
           is_linetouched
-               returns an error if the window pointer is null, or if the  line
+               returns  an error if the window pointer is null, or if the line
                number is outside the window.
 
                The constant ERR is distinct from TRUE and FALSE, which are the
-               normal return values of this function.   Because  the  function
+               normal  return  values  of this function.  Because the function
                returns a bool, returning ERR (which is neither TRUE nor FALSE)
                may not be supported by the compiler.
 
-               To provide error-checking and also match  the  X/Open  function
+               To  provide  error-checking  and also match the X/Open function
                prototype, the ERR is provided by a macro named is_linetouched.
                The actual function returns FALSE when it detects an error.
 
           wtouchln
-               returns an error if the window pointer is null, or if the  line
+               returns  an error if the window pointer is null, or if the line
                number is outside the window.

PORTABILITY

-       These  functions  were  introduced  by SVr4.  The Solaris curses header
+       These functions were introduced by SVr4.   The  Solaris  curses  header
        file, for instance, defines both an actual function and macro for each.
-       The  macros  give the same result as the actual functions.  SVr4 curses
-       does not check the window parameter win to ensure that it is not  NULL;
+       The macros give the same result as the actual functions.   SVr4  curses
+       does  not check the window parameter win to ensure that it is not NULL;
        otherwise this implementation behaves the same as SVr4.
 
        The XSI Curses standard, Issue 4 describes these functions, but defines
@@ -132,7 +133,7 @@
 
 
 
-ncurses 6.4                       2023-07-01                    curs_touch(3x)
+ncurses 6.4                       2023-09-16                    curs_touch(3x)

curs_trace 3x 2023-07-01 ncurses 6.4 Library calls

curs_trace 3x 2023-09-16 ncurses 6.4 Library calls

curs_trace 3x 2023-07-01 ncurses 6.4 Library calls

curs_trace 3x 2023-09-16 ncurses 6.4 Library calls

 curs_trace(3x)                   Library calls                  curs_trace(3x)
 
@@ -47,9 +47,9 @@

NAME

-       curses_trace, trace, _tracef, _traceattr, _traceattr2, _tracecchar_t,
+       curses_trace,  trace,  _tracef, _traceattr, _traceattr2, _tracecchar_t,
        _tracecchar_t2, _tracechar, _tracechtype, _tracechtype2, _nc_tracebits,
-       _tracedump, _tracemouse - curses debugging routines
+       _tracedump, _tracemouse - curses debugging routines

SYNOPSIS

@@ -77,8 +77,8 @@

DESCRIPTION

        The curses trace routines are used for debugging the ncurses libraries,
-       as well as applications which use the ncurses libraries.  Some  limita-
-       tions apply:
+       as  well  as  applications  which  use  the  ncurses  libraries.   Some
+       limitations apply:
 
        o   Aside from curses_trace, the other functions are normally available
            only with the debugging library e.g., libncurses_g.a.
@@ -98,9 +98,9 @@
 
        o   _tracef, which writes formatted data to the trace file.
 
-           The other functions either return a pointer to a string-area (allo-
-           cated by the corresponding function), or return no value  (such  as
-           _tracedump,  which  implements  the  screen dump for TRACE_UPDATE).
+           The  other  functions  either  return  a  pointer  to a string-area
+           (allocated by the corresponding function), or return no value (such
+           as  _tracedump, which implements the screen dump for TRACE_UPDATE).
            The caller should not free these strings, since the  allocation  is
            reused on successive calls.  To work around the problem of a single
            string-area per  function,  some  use  a  buffer-number  parameter,
@@ -109,26 +109,27 @@
        The curses_trace function is always available, whether or not the other
        trace functions are available:
 
-       o   If tracing is available, calling curses_trace with a nonzero param-
-           eter updates the trace mask, and returns the previous trace mask.
+       o   If tracing  is  available,  calling  curses_trace  with  a  nonzero
+           parameter  updates  the  trace mask, and returns the previous trace
+           mask.
 
            When the trace mask is nonzero, ncurses creates the file "trace" in
-           the current directory for output.  If the file already  exists,  no
+           the  current  directory for output.  If the file already exists, no
            tracing is done.
 
        o   If tracing is not available, curses_trace returns zero (0).

Trace Parameter

-       The  trace  parameter  is  formed  by  OR'ing  values  from the list of
+       The trace parameter is  formed  by  OR'ing  values  from  the  list  of
        TRACE_xxx definitions in <curses.h>.  These include:
 
        TRACE_DISABLE
             turn off tracing by passing a zero parameter.
 
-            The library flushes the output file, but retains an open  file-de-
-            scriptor  to the trace file so that it can resume tracing later if
-            a nonzero parameter is passed to the curses_trace function.
+            The  library  flushes  the  output file, but retains an open file-
+            descriptor to the trace file so that it can resume  tracing  later
+            if a nonzero parameter is passed to the curses_trace function.
 
        TRACE_TIMES
             trace user and system times of updates.
@@ -146,11 +147,11 @@
             trace all character outputs.
 
        TRACE_ORDINARY
-            trace all update actions.  The old and  new  screen  contents  are
+            trace  all  update  actions.   The old and new screen contents are
             written to the trace file for each refresh.
 
        TRACE_CALLS
-            trace  all curses calls.  The parameters for each call are traced,
+            trace all curses calls.  The parameters for each call are  traced,
             as well as return values.
 
        TRACE_VIRTPUT
@@ -177,69 +178,70 @@
        TRACE_MAXIMUM
             maximum trace level, enables all of the separate trace features.
 
-       Some tracing features are enabled whenever the  curses_trace  parameter
-       is  nonzero.   Some features overlap.  The specific names are used as a
+       Some  tracing  features are enabled whenever the curses_trace parameter
+       is nonzero.  Some features overlap.  The specific names are used  as  a
        guideline.

Initialization

-       These functions check the NCURSES_TRACE environment  variable,  to  set
+       These  functions  check  the NCURSES_TRACE environment variable, to set
        the tracing feature as if curses_trace was called:
 
-           filter, initscr, new_prescr, newterm, nofilter, restartterm,
-           ripoffline, setupterm, slk_init, tgetent, use_env,
+           filter,  initscr,  new_prescr,  newterm,   nofilter,   restartterm,
+           ripoffline,      setupterm,     slk_init,     tgetent,     use_env,
            use_extended_names, use_tioctl

Command-line Utilities

-       The  command-line  utilities  such  as  tic(1) provide a verbose option
-       which extends the set of messages written using the curses_trace  func-
-       tion.   Both  of  these  (-v  and  curses_trace)  use the same variable
+       The command-line utilities such as  tic(1)  provide  a  verbose  option
+       which  extends  the  set  of  messages  written  using the curses_trace
+       function.  Both of these (-v and curses_trace) use  the  same  variable
        (_nc_tracing), which determines the messages which are written.
 
-       Because the command-line utilities may  call  initialization  functions
-       such  as setupterm, tgetent or use_extended_names, some of their debug-
-       ging output may be directed to the trace file if the NCURSES_TRACE  en-
-       vironment variable is set:
+       Because  the  command-line  utilities may call initialization functions
+       such  as  setupterm,  tgetent  or  use_extended_names,  some  of  their
+       debugging output may be directed to the trace file if the NCURSES_TRACE
+       environment variable is set:
 
        o   messages produced in the utility are written to the standard error.
 
        o   messages produced by the underlying library are written to trace.
 
-       If  ncurses  is built without tracing, none of the latter are produced,
+       If ncurses is built without tracing, none of the latter  are  produced,
        and fewer diagnostics are provided by the command-line utilities.

RETURN VALUE

-       Routines which return a value are designed to be used as parameters  to
+       Routines  which return a value are designed to be used as parameters to
        the _tracef routine.

PORTABILITY

-       These  functions  are not part of the XSI interface.  Some other curses
-       implementations are known to have similar features, but  they  are  not
+       These functions are not part of the XSI interface.  Some  other  curses
+       implementations  are  known  to have similar features, but they are not
        compatible with ncurses:
 
-       o   SVr4  provided  traceon  and traceoff, to control whether debugging
-           information was written to the "trace" file.  While  the  functions
-           were  always  available, this feature was only enabled if DEBUG was
+       o   SVr4 provided traceon and traceoff, to  control  whether  debugging
+           information  was  written to the "trace" file.  While the functions
+           were always available, this feature was only enabled if  DEBUG  was
            defined when building the library.
 
            The SVr4 tracing feature is undocumented.
 
-       o   PDCurses provides traceon and traceoff, which (like SVr4)  are  al-
-           ways  available, and enable tracing to the "trace" file only when a
-           debug-library is built.
+       o   PDCurses  provides  traceon  and  traceoff,  which  (like SVr4) are
+           always available, and enable tracing to the "trace" file only  when
+           a debug-library is built.
 
-           PDCurses has a short description of these functions,  with  a  note
-           that  they are not present in X/Open Curses, ncurses or NetBSD.  It
-           does not mention SVr4, but the functions'  inclusion  in  a  header
+           PDCurses  has  a  short description of these functions, with a note
+           that they are not present in X/Open Curses, ncurses or NetBSD.   It
+           does  not  mention  SVr4,  but the functions' inclusion in a header
            file section labeled "Quasi-standard" hints at the origin.
 
-       o   NetBSD  does  not  provide functions for enabling/disabling traces.
-           It  uses  environment   variables   CURSES_TRACE_MASK   and   CURS-
-           ES_TRACE_FILE  to  determine  what is traced, and where the results
-           are written.  This is available only when a debug-library is built.
+       o   NetBSD does not provide functions  for  enabling/disabling  traces.
+           It     uses    environment    variables    CURSES_TRACE_MASK    and
+           CURSES_TRACE_FILE to  determine  what  is  traced,  and  where  the
+           results  are  written.  This is available only when a debug-library
+           is built.
 
            The NetBSD tracing feature is undocumented.
 
@@ -257,7 +259,7 @@
 
 
 
-ncurses 6.4                       2023-07-01                    curs_trace(3x)
+ncurses 6.4                       2023-09-16                    curs_trace(3x)

curs_util 3x 2023-08-19 ncurses 6.4 Library calls

curs_util 3x 2023-09-16 ncurses 6.4 Library calls

curs_util 3x 2023-08-19 ncurses 6.4 Library calls

curs_util 3x 2023-09-16 ncurses 6.4 Library calls

 curs_util(3x)                    Library calls                   curs_util(3x)
 
@@ -48,8 +48,8 @@

NAME

-       delay_output, filter, flushinp, getwin, key_name, keyname, nofilter,
-       putwin, unctrl, use_env, use_tioctl, wunctrl - miscellaneous curses
+       delay_output,  filter,  flushinp,  getwin, key_name, keyname, nofilter,
+       putwin, unctrl, use_env, use_tioctl,  wunctrl  -  miscellaneous  curses
        utility routines
 
 
@@ -80,11 +80,11 @@

DESCRIPTION

unctrl

-       The unctrl routine returns a character string which is a printable rep-
-       resentation of the character c:
+       The  unctrl  routine  returns  a  character string which is a printable
+       representation of the character c:
 
-       o   Printable characters are displayed as themselves, e.g., a one-char-
-           acter string containing the key.
+       o   Printable characters are displayed  as  themselves,  e.g.,  a  one-
+           character string containing the key.
 
        o   Control characters are displayed in the ^X notation.
 
@@ -93,13 +93,13 @@
        o   DEL (character 127) is displayed as ^?.
 
        o   Values  above 128 are either meta characters (if the screen has not
-           been initialized, or if meta(3x) has been called with a TRUE param-
-           eter),  shown  in the M-X notation, or are displayed as themselves.
-           In the latter case, the values may not be printable;  this  follows
-           the X/Open specification.
+           been initialized, or if  meta(3x)  has  been  called  with  a  TRUE
+           parameter),  shown  in  the  M-X  notation,  or  are  displayed  as
+           themselves.  In the latter case, the values may not  be  printable;
+           this follows the X/Open specification.
 
-       The  corresponding wunctrl returns a printable representation of a com-
-       plex character c.
+       The  corresponding  wunctrl  returns  a  printable  representation of a
+       complex character c.
 
        In both unctrl and wunctrl the attributes and color associated with the
        character parameter are ignored.
@@ -109,20 +109,20 @@
        The keyname routine returns a character string corresponding to the key
        c.  Key codes are different from character codes.
 
-       o   Key codes below 256 are characters.  They are displayed using  unc-
-           trl.
+       o   Key codes below 256  are  characters.   They  are  displayed  using
+           unctrl.
 
        o   Values  above 256 may be the codes for function keys.  The function
            key name is displayed.
 
        o   Otherwise (if there is no corresponding name and the key is  not  a
            character)  the  function returns null, to denote an error.  X/Open
-           also lists an "UNKNOWN KEY" return value,  which  some  implementa-
-           tions return rather than null.
+           also  lists   an   "UNKNOWN   KEY"   return   value,   which   some
+           implementations return rather than null.
 
-       The  corresponding key_name returns a multibyte character string corre-
-       sponding to the wide-character value w.  The two functions (keyname and
-       key_name) do not return the same set of strings:
+       The   corresponding  key_name  returns  a  multibyte  character  string
+       corresponding  to  the  wide-character  value  w.   The  two  functions
+       (keyname and key_name) do not return the same set of strings:
 
        o   keyname returns null where key_name would display a meta character.
 
@@ -135,8 +135,8 @@
 
        o   LINES is set to 1;
 
-       o   the capabilities clear, cud1, cud, cup, cuu1,  cuu,  vpa  are  dis-
-           abled;
+       o   the  capabilities  clear,  cud1,  cud,  cup,  cuu1,  cuu,  vpa  are
+           disabled;
 
        o   the capability ed is disabled if bce is set;
 
@@ -150,26 +150,26 @@

use_env

        The use_env routine, if  used,  should  be  called  before  initscr  or
-       newterm  are  called (because those compute the screen size).  It modi-
-       fies the way ncurses treats environment variables when determining  the
-       screen size.
+       newterm  are  called  (because  those  compute  the  screen  size).  It
+       modifies the way ncurses treats environment variables when  determining
+       the screen size.
 
        o   Normally  ncurses  looks  first  at  the  terminal database for the
            screen size.
 
-           If use_env was called with FALSE for parameter, it stops  here  un-
-           less use_tioctl was also called with TRUE for parameter.
+           If use_env was called with  FALSE  for  parameter,  it  stops  here
+           unless use_tioctl was also called with TRUE for parameter.
 
        o   Then  it  asks  for the screen size via operating system calls.  If
            successful, it overrides the values from the terminal database.
 
        o   Finally (unless use_env was called with FALSE  parameter),  ncurses
            examines  the LINES or COLUMNS environment variables, using a value
-           in those to override the results from the operating system or  ter-
-           minal database.
+           in those to override the  results  from  the  operating  system  or
+           terminal database.
 
-           Ncurses  also  updates the screen size in response to SIGWINCH, un-
-           less overridden by the LINES or COLUMNS environment variables,
+           Ncurses  also  updates  the  screen  size  in response to SIGWINCH,
+           unless overridden by the LINES or COLUMNS environment variables,

use_tioctl

@@ -193,13 +193,13 @@
            use_env   use_tioctl   Summary
            ----------------------------------------------------------------
            TRUE      FALSE        This  is  the default behavior.  ncurses
-                                  uses operating system calls unless over-
-                                  ridden by $LINES or $COLUMNS environment
-                                  variables.
+                                  uses  operating  system   calls   unless
+                                  overridden   by   $LINES   or   $COLUMNS
+                                  environment variables.
            TRUE      TRUE         ncurses  updates  $LINES  and   $COLUMNS
                                   based on operating system calls.
-           FALSE     TRUE         ncurses ignores $LINES and $COLUMNS, us-
-                                  es  operating  system  calls  to  obtain
+           FALSE     TRUE         ncurses  ignores  $LINES  and  $COLUMNS,
+                                  uses operating system  calls  to  obtain
                                   size.
            FALSE     FALSE        ncurses  relies on the terminal database
                                   to determine size.
@@ -207,18 +207,18 @@

putwin/getwin

        The putwin routine writes all data associated with window (or pad)  win
-       into the file to which filep points.  This information can be later re-
-       trieved using the getwin function.
+       into  the  file  to  which filep points.  This information can be later
+       retrieved using the getwin function.
 
        The getwin routine reads window related data  stored  in  the  file  by
        putwin.   The  routine  then creates and initializes a new window using
        that data.  It returns a pointer to the new window.  There  are  a  few
        caveats:
 
-       o   the data written is a copy of the WINDOW structure, and its associ-
-           ated character cells.  The format differs between the  wide-charac-
-           ter  (ncursesw) and non-wide (ncurses) libraries.  You can transfer
-           data between the two, however.
+       o   the  data  written  is  a  copy  of  the  WINDOW structure, and its
+           associated character cells.  The format differs between  the  wide-
+           character  (ncursesw)  and  non-wide  (ncurses) libraries.  You can
+           transfer data between the two, however.
 
        o   the retrieved window is always created as a  top-level  window  (or
            pad), rather than a subwindow.
@@ -232,8 +232,8 @@

delay_output

        The delay_output routine inserts an ms  millisecond  pause  in  output.
        This  routine should not be used extensively because padding characters
-       are used rather than a CPU pause.  If no padding  character  is  speci-
-       fied, this uses napms to perform the delay.
+       are used  rather  than  a  CPU  pause.   If  no  padding  character  is
+       specified, this uses napms to perform the delay.

flushinp

@@ -254,8 +254,8 @@
                returns an error if the terminal was not initialized.
 
           putwin
-               returns an error if the associated fwrite calls return  an  er-
-               ror.
+               returns an error if  the  associated  fwrite  calls  return  an
+               error.

PORTABILITY

@@ -267,10 +267,10 @@

keyname

-       The  keyname function may return the names of user-defined string capa-
-       bilities which are defined in the terminfo entry via the -x  option  of
-       tic.  This implementation automatically assigns at run-time keycodes to
-       user-defined strings which begin  with  "k".   The  keycodes  start  at
+       The  keyname  function  may  return  the  names  of user-defined string
+       capabilities which are defined in the terminfo entry via the -x  option
+       of tic.  This implementation automatically assigns at run-time keycodes
+       to user-defined strings which begin with "k".  The  keycodes  start  at
        KEY_MAX, but are not guaranteed to be the same value for different runs
        because user-defined codes are merged from  all  terminal  descriptions
        which  have  been loaded.  The use_extended_names(3x) function controls
@@ -281,16 +281,16 @@

nofilter/use_tioctl

        The  nofilter  and  use_tioctl  routines are specific to ncurses.  They
        were not supported on Version 7, BSD or System V  implementations.   It
-       is  recommended that any code depending on ncurses extensions be condi-
-       tioned using NCURSES_VERSION.
+       is  recommended  that  any  code  depending  on  ncurses  extensions be
+       conditioned using NCURSES_VERSION.

putwin/getwin file-format

        The putwin and getwin functions have several issues with portability:
 
-       o   The files written and read by these functions  use  an  implementa-
-           tion-specific format.  Although the format is an obvious target for
-           standardization, it has been overlooked.
+       o   The  files  written  and   read   by   these   functions   use   an
+           implementation-specific  format.  Although the format is an obvious
+           target for standardization, it has been overlooked.
 
            Interestingly enough, according to the copyright dates  in  Solaris
            source,  the  functions (along with scr_init, etc.) originated with
@@ -323,9 +323,9 @@
 
        o   the parameter is in the range 128-159, i.e., a C1 control code.  If
            use_legacy_coding(3x) has been called with a  2  parameter,  unctrl
-           returns the parameter, i.e., a one-character string with the param-
-           eter as the first character.  Otherwise,  it  returns  "~@",  "~A",
-           etc., analogous to "^@", "^A", C0 controls.
+           returns  the  parameter,  i.e.,  a  one-character  string  with the
+           parameter as the first  character.   Otherwise,  it  returns  "~@",
+           "~A", etc., analogous to "^@", "^A", C0 controls.
 
            X/Open Curses does not document whether unctrl can be called before
            initializing curses.  This implementation permits that, and returns
@@ -336,42 +336,43 @@
 
        The strings returned by unctrl in this implementation are determined at
        compile  time,  showing C1 controls from the upper-128 codes with a "~"
-       prefix rather than "^".  Other implementations have  different  conven-
-       tions.  For example, they may show both sets of control characters with
-       "^", and strip the parameter to 7 bits.  Or they may ignore C1 controls
-       and treat all of the upper-128 codes as printable.  This implementation
-       uses 8 bits but does not modify the  string  to  reflect  locale.   The
-       use_legacy_coding(3x)  function  allows the caller to change the output
-       of unctrl.
+       prefix  rather  than  "^".   Other   implementations   have   different
+       conventions.    For  example,  they  may  show  both  sets  of  control
+       characters with "^", and strip the parameter to 7 bits.   Or  they  may
+       ignore  C1  controls and treat all of the upper-128 codes as printable.
+       This implementation uses 8 bits but  does  not  modify  the  string  to
+       reflect  locale.   The use_legacy_coding(3x) function allows the caller
+       to change the output of unctrl.
 
        Likewise, the meta(3x) function allows the caller to change the  output
        of  keyname,  i.e.,  it  determines  whether to use the "M-" prefix for
-       "meta" keys (codes in the range  128  to  255).   Both  use_legacy_cod-
-       ing(3x)  and meta(3x) succeed only after curses is initialized.  X/Open
-       Curses does not document the treatment  of  codes  128  to  159.   When
-       treating them as "meta" keys (or if keyname is called before initializ-
-       ing curses), this implementation returns strings "M-^@", "M-^A", etc.
+       "meta"   keys   (codes   in   the   range   128    to    255).     Both
+       use_legacy_coding(3x)   and  meta(3x)  succeed  only  after  curses  is
+       initialized.  X/Open Curses does not document the  treatment  of  codes
+       128 to 159.  When treating them as "meta" keys (or if keyname is called
+       before  initializing  curses),  this  implementation  returns   strings
+       "M-^@", "M-^A", etc.
 
        X/Open Curses documents unctrl as declared in <unctrl.h>, which ncurses
-       does.   However,  ncurses' <curses.h> includes <unctrl.h>, matching the
+       does.  However, ncurses' <curses.h> includes <unctrl.h>,  matching  the
        behavior of SVr4 curses.  Other implementations may not do that.

use_env/use_tioctl

-       If ncurses is configured to provide  the  sp-functions  extension,  the
-       state  of  use_env  and  use_tioctl may be updated before creating each
-       screen rather than once  only  (curs_sp_funcs(3x)).   This  feature  of
+       If  ncurses  is  configured  to provide the sp-functions extension, the
+       state of use_env and use_tioctl may be  updated  before  creating  each
+       screen  rather  than  once  only  (curs_sp_funcs(3x)).  This feature of
        use_env is not provided by other implementations of curses.

curs_variables 3x 2021-12-25 ncurses 6.4 Library calls

curs_variables 3x 2023-09-16 ncurses 6.4 Library calls

 curs_variables(3x)               Library calls              curs_variables(3x)
 
@@ -47,8 +47,8 @@

NAME

-       COLORS, COLOR_PAIRS, COLS, ESCDELAY, LINES, TABSIZE, curscr, newscr,
-       stdscr - curses global variables
+       COLORS,  COLOR_PAIRS,  COLS,  ESCDELAY, LINES, TABSIZE, curscr, newscr,
+       stdscr - curses global variables

SYNOPSIS

@@ -101,8 +101,8 @@

ESCDELAY

        This variable holds the number of milliseconds to wait after reading an
        escape character, to distinguish between an individual escape character
-       entered on the keyboard from escape sequences sent by cursor- and func-
-       tion-keys (see curses(3x)).
+       entered  on  the  keyboard  from  escape  sequences sent by cursor- and
+       function-keys (see curses(3x)).

LINES

@@ -112,8 +112,8 @@

TABSIZE

        This  variable  holds  the number of columns used by the curses library
-       when converting a tab character to spaces as it adds the tab to a  win-
-       dow (see curs_addch(3x).
+       when converting a tab character to spaces as  it  adds  the  tab  to  a
+       window (see curs_addch(3x).

The Current Screen

@@ -125,8 +125,8 @@

The New Screen

-       This  implementation of curses uses a special window newscr to hold up-
-       dates to the terminal screen before applying them to curscr.
+       This  implementation  of  curses  uses  a special window newscr to hold
+       updates to the terminal screen before applying them to curscr.
 
        This is referred to as the "virtual  screen"  in  the  curs_kernel(3x),
        curs_refresh(3x) and curs_outopts(3x) manual pages.
@@ -150,22 +150,22 @@
        TABSIZE  is  a feature of SVr4 curses which is not documented by X/Open
        curses.
 
-       o   In SVr4 curses, TABSIZE is initially set from the terminal descrip-
-           tion's  init_tabs capability.  After that, it can be altered by the
-           applications using SVr4 curses.
+       o   In  SVr4  curses,  TABSIZE  is  initially  set  from  the  terminal
+           description's  init_tabs capability.  After that, it can be altered
+           by the applications using SVr4 curses.
 
-           SVr4 curses uses the current value of TABSIZE to compute the  posi-
-           tion  of  tabstops  for  updating both the virtual screen with add-
-           ch(3x) as well as the physical screen with mvcur(3x).
+           SVr4 curses uses the  current  value  of  TABSIZE  to  compute  the
+           position  of  tabstops  for  updating  both the virtual screen with
+           addch(3x) as well as the physical screen with mvcur(3x).
 
-       o   This implementation uses the current value of TABSIZE only for  up-
-           dating  the  virtual screen.  It uses the terminal description's it
+       o   This implementation uses the current  value  of  TABSIZE  only  for
+           updating the virtual screen.  It uses the terminal description's it
            (init_tabs) capability for computing hardware tabs (i.e., tab stops
            on the physical screen).
 
        o   Other  implementations  differ.  For instance, NetBSD curses allows
-           TABSIZE to be set through an environment variable.  This  implemen-
-           tation does not.
+           TABSIZE  to  be  set  through  an   environment   variable.    This
+           implementation does not.
 
            NetBSD curses does not support hardware tabs; it uses the init_tabs
            capability and the TABSIZE variable only for updating  the  virtual
@@ -177,8 +177,8 @@
 
        o   The default value for AIX's ESCDELAY is 0.1 seconds.
 
-       o   AIX  also enforces a limit of 10,000 seconds for ESCDELAY; this im-
-           plementation currently has no upper limit.
+       o   AIX  also  enforces  a  limit  of 10,000 seconds for ESCDELAY; this
+           implementation currently has no upper limit.
 
        This implementation has long used ESCDELAY with units of  milliseconds,
        making  it  impossible to be completely compatible with AIX.  Likewise,
@@ -192,7 +192,7 @@
 
 
 
-ncurses 6.4                       2021-12-25                curs_variables(3x)
+ncurses 6.4                       2023-09-16                curs_variables(3x)

curs_window 3x 2023-07-01 ncurses 6.4 Library calls

curs_window 3x 2023-09-16 ncurses 6.4 Library calls

curs_window 3x 2023-07-01 ncurses 6.4 Library calls

curs_window 3x 2023-09-16 ncurses 6.4 Library calls

 curs_window(3x)                  Library calls                 curs_window(3x)
 
@@ -47,8 +47,8 @@

NAME

-       newwin, delwin, mvwin, subwin, derwin, mvderwin, dupwin, wsyncup,
-       syncok, wcursyncup, wsyncdown - create curses windows
+       newwin,  delwin,  mvwin,  subwin,  derwin,  mvderwin,  dupwin, wsyncup,
+       syncok, wcursyncup, wsyncdown - create and manipulate curses windows

SYNOPSIS

@@ -99,8 +99,8 @@

delwin

        Calling delwin deletes the named window, freeing all memory  associated
-       with  it  (it does not actually erase the window's screen image).  Sub-
-       windows must be deleted before the main window can be deleted.
+       with  it  (it  does  not  actually  erase  the  window's screen image).
+       Subwindows must be deleted before the main window can be deleted.

mvwin

@@ -115,8 +115,8 @@
        given number of lines, nlines, and columns, ncols.  The  window  is  at
        position (begin_y, begin_x) on the screen.  The subwindow shares memory
        with the window orig, so that changes made to one  window  will  affect
-       both  windows.  When using this routine, it is necessary to call touch-
-       win or touchline on orig before calling wrefresh on the subwindow.
+       both  windows.   When  using  this  routine,  it  is  necessary to call
+       touchwin or touchline on orig before calling wrefresh on the subwindow.

derwin

@@ -125,8 +125,8 @@
        screen.  There is no difference between the subwindows and the  derived
        windows.
 
-       Calling  mvderwin moves a derived window (or subwindow) inside its par-
-       ent window.  The screen-relative  parameters  of  the  window  are  not
+       Calling  mvderwin  moves  a  derived  window  (or subwindow) inside its
+       parent window.  The screen-relative parameters of the  window  are  not
        changed.  This routine is used to display different parts of the parent
        window at the same physical position on the screen.
 
@@ -138,14 +138,14 @@

wsyncup

        Calling wsyncup touches all locations in  ancestors  of  win  that  are
        changed  in  win.   If  syncok is called with second argument TRUE then
-       wsyncup is called automatically whenever there is a change in the  win-
-       dow.
+       wsyncup is called automatically whenever  there  is  a  change  in  the
+       window.

wsyncdown

        The  wsyncdown  routine  touches  each  location  in  win that has been
-       touched in any of its ancestor windows.  This routine is called by wre-
-       fresh, so it should almost never be necessary to call it manually.
+       touched in any of its ancestor windows.   This  routine  is  called  by
+       wrefresh, so it should almost never be necessary to call it manually.

wcursyncup

@@ -156,8 +156,8 @@

RETURN VALUE

        Routines that return an integer return the integer ERR upon failure and
-       OK (SVr4 only specifies "an integer value other than  ERR")  upon  suc-
-       cessful completion.
+       OK (SVr4 only  specifies  "an  integer  value  other  than  ERR")  upon
+       successful completion.
 
        Routines that return pointers return NULL on error.
 
@@ -176,8 +176,8 @@
             returns an error if the window pointer is null.
 
             This implementation also maintains a list of windows,  and  checks
-            that  the pointer passed to delwin is one that it created, return-
-            ing an error if it was not..
+            that  the  pointer  passed  to  delwin  is  one  that  it created,
+            returning an error if it was not..
 
        mvderwin
             returns an error if the window pointer is null, or if some part of
@@ -219,11 +219,11 @@
        tested.
 
        The System V curses documentation is very unclear  about  what  wsyncup
-       and  wsyncdown  actually do.  It seems to imply that they are only sup-
-       posed to touch exactly  those  lines  that  are  affected  by  ancestor
-       changes.  The language here, and the behavior of the curses implementa-
-       tion, is patterned on the XPG4 curses standard.  The weaker  XPG4  spec
-       may result in slower updates.
+       and  wsyncdown  actually  do.   It  seems  to  imply that they are only
+       supposed to touch exactly those lines that  are  affected  by  ancestor
+       changes.    The   language   here,  and  the  behavior  of  the  curses
+       implementation, is patterned on the XPG4 curses standard.   The  weaker
+       XPG4 spec may result in slower updates.

PORTABILITY

@@ -237,12 +237,12 @@
            if the curses library keeps a list of the subwindows.  SVr4  curses
            kept  a  count  of the number of subwindows rather than a list.  It
            simply returned ERR when asked  to  delete  a  subwindow.   Solaris
-           X/Open curses does not even make that check, and will delete a par-
-           ent window which still has subwindows.
+           X/Open  curses  does  not  even  make that check, and will delete a
+           parent window which still has subwindows.
 
        o   Since release 4.0 (1996), ncurses maintains a list of  windows  for
-           each  screen,  to ensure that a window has no subwindows before al-
-           lowing deletion.
+           each  screen,  to  ensure  that  a  window has no subwindows before
+           allowing deletion.
 
        o   NetBSD copied this feature of ncurses in 2003.
            PDCurses follows the scheme used in Solaris X/Open curses.
@@ -254,7 +254,7 @@
 
 
 
-ncurses 6.4                       2023-07-01                   curs_window(3x)
+ncurses 6.4                       2023-09-16                   curs_window(3x)

default_colors 3x 2023-08-19 ncurses 6.4 Library calls

default_colors 3x 2023-09-16 ncurses 6.4 Library calls

default_colors 3x 2023-08-19 ncurses 6.4 Library calls

default_colors 3x 2023-09-16 ncurses 6.4 Library calls

 default_colors(3x)               Library calls              default_colors(3x)
 
@@ -149,7 +149,7 @@
 
 
 
-ncurses 6.4                       2023-08-19                default_colors(3x)
+ncurses 6.4                       2023-09-16                default_colors(3x)

define_key 3x 2022-02-12 ncurses 6.4 Library calls

define_key 3x 2023-09-16 ncurses 6.4 Library calls

define_key 3x 2022-02-12 ncurses 6.4 Library calls

define_key 3x 2023-09-16 ncurses 6.4 Library calls

 define_key(3x)                   Library calls                  define_key(3x)
 
@@ -48,7 +48,7 @@

NAME

-       define_key - define a keycode
+       define_key - define a curses keycode

SYNOPSIS

@@ -90,7 +90,7 @@
 
 
 
-ncurses 6.4                       2022-02-12                    define_key(3x)
+ncurses 6.4                       2023-09-16                    define_key(3x)

form 3x 2023-08-19 ncurses 6.4 Library calls

form 3x 2023-09-16 ncurses 6.4 Library calls

form 3x 2023-08-19 ncurses 6.4 Library calls

form 3x 2023-09-16 ncurses 6.4 Library calls

 form(3x)                         Library calls                        form(3x)
 
@@ -248,11 +248,11 @@
        curses(3x) and related pages whose names  begin  "form_"  for  detailed
        descriptions of the entry points.
 
-       This describes ncurses version 6.4 (patch 20230909).
+       This describes ncurses version 6.4 (patch 20230917).
 
 
 
-ncurses 6.4                       2023-08-19                          form(3x)
+ncurses 6.4                       2023-09-16                          form(3x)

form_cursor 3x 2023-07-01 ncurses 6.4 Library calls

form_cursor 3x 2023-09-16 ncurses 6.4 Library calls

form_cursor 3x 2023-07-01 ncurses 6.4 Library calls

form_cursor 3x 2023-09-16 ncurses 6.4 Library calls

 form_cursor(3x)                  Library calls                 form_cursor(3x)
 
@@ -99,7 +99,7 @@
 
 
 
-ncurses 6.4                       2023-07-01                   form_cursor(3x)
+ncurses 6.4                       2023-09-16                   form_cursor(3x)

form_data 3x 2023-07-01 ncurses 6.4 Library calls

form_data 3x 2023-09-16 ncurses 6.4 Library calls

form_data 3x 2023-07-01 ncurses 6.4 Library calls

form_data 3x 2023-09-16 ncurses 6.4 Library calls

 form_data(3x)                    Library calls                   form_data(3x)
 
@@ -86,7 +86,7 @@
 
 
 
-ncurses 6.4                       2023-07-01                     form_data(3x)
+ncurses 6.4                       2023-09-16                     form_data(3x)

form_driver 3x 2023-08-19 ncurses 6.4 Library calls

form_driver 3x 2023-09-16 ncurses 6.4 Library calls

form_driver 3x 2023-08-19 ncurses 6.4 Library calls

form_driver 3x 2023-09-16 ncurses 6.4 Library calls

 form_driver(3x)                  Library calls                 form_driver(3x)
 
@@ -280,7 +280,7 @@
 
 
 
-ncurses 6.4                       2023-08-19                   form_driver(3x)
+ncurses 6.4                       2023-09-16                   form_driver(3x)

form_field 3x 2023-07-01 ncurses 6.4 Library calls

form_field 3x 2023-09-16 ncurses 6.4 Library calls

form_field 3x 2023-07-01 ncurses 6.4 Library calls

form_field 3x 2023-09-16 ncurses 6.4 Library calls

 form_field(3x)                   Library calls                  form_field(3x)
 
@@ -119,7 +119,7 @@
 
 
 
-ncurses 6.4                       2023-07-01                    form_field(3x)
+ncurses 6.4                       2023-09-16                    form_field(3x)

form_field_attributes 3x 2023-07-01 ncurses 6.4 Library calls

form_field_attributes 3x 2023-09-16 ncurses 6.4 Library calls

form_field_attributes 3x 2023-07-01 ncurses 6.4 Library calls

form_field_attributes 3x 2023-09-16 ncurses 6.4 Library calls

 form_field_attributes(3x)        Library calls       form_field_attributes(3x)
 
@@ -113,7 +113,7 @@
 
 
 
-ncurses 6.4                       2023-07-01         form_field_attributes(3x)
+ncurses 6.4                       2023-09-16         form_field_attributes(3x)

form_field_buffer 3x 2023-07-01 ncurses 6.4 Library calls

form_field_buffer 3x 2023-09-16 ncurses 6.4 Library calls

form_field_buffer 3x 2023-07-01 ncurses 6.4 Library calls

form_field_buffer 3x 2023-09-16 ncurses 6.4 Library calls

 form_field_buffer(3x)            Library calls           form_field_buffer(3x)
 
@@ -155,7 +155,7 @@
 
 
 
-ncurses 6.4                       2023-07-01             form_field_buffer(3x)
+ncurses 6.4                       2023-09-16             form_field_buffer(3x)

form_field_info 3x 2022-02-12 ncurses 6.4 Library calls

form_field_info 3x 2023-09-16 ncurses 6.4 Library calls

form_field_info 3x 2022-02-12 ncurses 6.4 Library calls

form_field_info 3x 2023-09-16 ncurses 6.4 Library calls

 form_field_info(3x)              Library calls             form_field_info(3x)
 
@@ -112,7 +112,7 @@
 
 
 
-ncurses 6.4                       2022-02-12               form_field_info(3x)
+ncurses 6.4                       2023-09-16               form_field_info(3x)

form_field_just 3x 2023-07-01 ncurses 6.4 Library calls

form_field_just 3x 2023-09-16 ncurses 6.4 Library calls

form_field_just 3x 2023-07-01 ncurses 6.4 Library calls

form_field_just 3x 2023-09-16 ncurses 6.4 Library calls

 form_field_just(3x)              Library calls             form_field_just(3x)
 
@@ -101,7 +101,7 @@
 
 
 
-ncurses 6.4                       2023-07-01               form_field_just(3x)
+ncurses 6.4                       2023-09-16               form_field_just(3x)

form_field_new 3x 2023-07-01 ncurses 6.4 Library calls

form_field_new 3x 2023-09-16 ncurses 6.4 Library calls

form_field_new 3x 2023-07-01 ncurses 6.4 Library calls

form_field_new 3x 2023-09-16 ncurses 6.4 Library calls

 form_field_new(3x)               Library calls              form_field_new(3x)
 
@@ -128,7 +128,7 @@
 
 
 
-ncurses 6.4                       2023-07-01                form_field_new(3x)
+ncurses 6.4                       2023-09-16                form_field_new(3x)

form_field_opts 3x 2023-07-01 ncurses 6.4 Library calls

form_field_opts 3x 2023-09-16 ncurses 6.4 Library calls

form_field_opts 3x 2023-07-01 ncurses 6.4 Library calls

form_field_opts 3x 2023-09-16 ncurses 6.4 Library calls

 form_field_opts(3x)              Library calls             form_field_opts(3x)
 
@@ -170,7 +170,7 @@
 
 
 
-ncurses 6.4                       2023-07-01               form_field_opts(3x)
+ncurses 6.4                       2023-09-16               form_field_opts(3x)

form_field_userptr 3x 2022-02-12 ncurses 6.4 Library calls

form_field_userptr 3x 2023-09-16 ncurses 6.4 Library calls

form_field_userptr 3x 2022-02-12 ncurses 6.4 Library calls

form_field_userptr 3x 2023-09-16 ncurses 6.4 Library calls

 form_field_userptr(3x)           Library calls          form_field_userptr(3x)
 
@@ -95,7 +95,7 @@
 
 
 
-ncurses 6.4                       2022-02-12            form_field_userptr(3x)
+ncurses 6.4                       2023-09-16            form_field_userptr(3x)

form_field_validation 3x 2023-07-01 ncurses 6.4 Library calls

form_field_validation 3x 2023-09-16 ncurses 6.4 Library calls

form_field_validation 3x 2023-07-01 ncurses 6.4 Library calls

form_field_validation 3x 2023-09-16 ncurses 6.4 Library calls

 form_field_validation(3x)        Library calls       form_field_validation(3x)
 
@@ -92,7 +92,7 @@
        Several field types are predefined by the form library.
 
 
-

PREDEFINED TYPES

        It is possible to set up new  programmer-defined  field  types.   Field
        types  are implemented via the FIELDTYPE data structure, which contains
        several pointers to functions.
@@ -102,100 +102,102 @@
 
        The predefined types are as follows:
 
-       TYPE_ALNUM
-            Alphanumeric data.  Required parameter:
 
-            o   a third int argument, a minimum field width.
+

TYPE_ALNUM

+       Alphanumeric data.  Required parameter:
 
-       TYPE_ALPHA
-            Character data.  Required parameter:
+       o   a third int argument, a minimum field width.
 
-            o   a third int argument, a minimum field width.
 
-       TYPE_ENUM
-            Accept one of a specified set of strings.  Required parameters:
+

TYPE_ALPHA

+       Character data.  Required parameter:
 
-            o   a third (char **) argument pointing to a string list;
+       o   a third int argument, a minimum field width.
 
-            o   a fourth int flag argument to enable case-sensitivity;
 
-            o   a  fifth  int flag argument specifying whether a partial match
-                must be a unique one.  If this flag is off, a  prefix  matches
-                the  first of any set of more than one list elements with that
-                prefix.
+

TYPE_ENUM

+       Accept one of a specified set of strings.  Required parameters:
 
-            The library copies the string list, so you may  use  a  list  that
-            lives in automatic variables on the stack.
+       o   a third (char **) argument pointing to a string list;
 
-       TYPE_INTEGER
-            Integer  data,  parsable  to  an  integer  by  atoi(3).   Required
-            parameters:
+       o   a fourth int flag argument to enable case-sensitivity;
 
-            o   a third int argument controlling the precision,
+       o   a  fifth  int flag argument specifying whether a partial match must
+           be a unique one.  If this flag is off, a prefix matches  the  first
+           of any set of more than one list elements with that prefix.
 
-            o   a fourth long argument constraining minimum value,
+       The library copies the string list, so you may use a list that lives in
+       automatic variables on the stack.
 
-            o   a fifth long constraining maximum value.  If the maximum value
-                is  less  than  or  equal  to  the minimum value, the range is
-                simply ignored.
 
-            On return, the field buffer is formatted according to  the  printf
-            format  specification  ".*ld",  where  the  "*" is replaced by the
-            precision argument.
+

TYPE_INTEGER

+       Integer data, parsable to an integer by atoi(3).  Required parameters:
 
-            For details of the precision handling see printf(3).
+       o   a third int argument controlling the precision,
 
-       TYPE_NUMERIC
-            Numeric  data  (may  have   a   decimal-point   part).    Required
-            parameters:
+       o   a fourth long argument constraining minimum value,
 
-            o   a third int argument controlling the precision,
+       o   a fifth long constraining maximum value.  If the maximum  value  is
+           less  than  or  equal  to  the  minimum  value, the range is simply
+           ignored.
 
-            o   a fourth double argument constraining minimum value,
+       On return, the field buffer is formatted according to the printf format
+       specification  ".*ld",  where  the  "*"  is  replaced  by the precision
+       argument.
 
-            o   and a fifth double constraining maximum value.  If your system
-                supports locales, the decimal point character must be the  one
-                specified  by  your locale.  If the maximum value is less than
-                or equal to the minimum value, the range is simply ignored.
+       For details of the precision handling see printf(3).
 
-            On return, the field buffer is formatted according to  the  printf
-            format  specification  ".*f",  where  the  "*"  is replaced by the
-            precision argument.
 
-            For details of the precision handling see printf(3).
+

TYPE_NUMERIC

+       Numeric data (may have a decimal-point part).  Required parameters:
 
-       TYPE_REGEXP
-            Regular expression data.  Required parameter:
+       o   a third int argument controlling the precision,
 
-            o   a third argument, a regular expression (char *)  string.   The
-                data is valid if the regular expression matches it.
+       o   a fourth double argument constraining minimum value,
 
-            Regular expressions are in the format of regcomp and regexec.
+       o   and a fifth double constraining  maximum  value.   If  your  system
+           supports  locales,  the  decimal  point  character  must be the one
+           specified by your locale.  If the maximum value  is  less  than  or
+           equal to the minimum value, the range is simply ignored.
 
-            The  regular  expression  must match the whole field.  If you have
-            for example, an eight character wide field, a  regular  expression
-            "^[0-9]*$"  always means that you have to fill all eight positions
-            with digits.  If you want to allow fewer digits, you may  use  for
-            example  "^[0-9]*  *$" which is good for trailing spaces (up to an
-            empty field), or "^ *[0-9]* *$" which  is  good  for  leading  and
-            trailing spaces around the digits.
+       On return, the field buffer is formatted according to the printf format
+       specification ".*f",  where  the  "*"  is  replaced  by  the  precision
+       argument.
 
-       TYPE_IPV4
-            An Internet Protocol Version 4 address.  Required parameter:
+       For details of the precision handling see printf(3).
 
-            o   none
 
-            The  form  library  checks  whether or not the buffer has the form
-            a.b.c.d, where a, b, c, and d are numbers in the range 0  to  255.
-            Trailing  blanks in the buffer are ignored.  The address itself is
-            not validated.
+

TYPE_REGEXP

+       Regular expression data.  Required parameter:
 
-            This is an ncurses extension; this field type may not be available
-            in other curses implementations.
+       o   a  third  argument, a regular expression (char *) string.  The data
+           is valid if the regular expression matches it.
+
+       Regular expressions are in the format of regcomp and regexec.
+
+       The regular expression must match the whole field.   If  you  have  for
+       example, an eight character wide field, a regular expression "^[0-9]*$"
+       always means that you have to fill all eight positions with digits.  If
+       you  want  to  allow fewer digits, you may use for example "^[0-9]* *$"
+       which is good for trailing spaces (up to an empty field), or "^ *[0-9]*
+       *$" which is good for leading and trailing spaces around the digits.
+
+
+

TYPE_IPV4

+       An Internet Protocol Version 4 address.  Required parameter:
+
+       o   none
+
+       The form library checks whether or not the buffer has the form a.b.c.d,
+       where a, b, c, and d are numbers in  the  range  0  to  255.   Trailing
+       blanks in the buffer are ignored.  The address itself is not validated.
+
+       This  is  an ncurses extension; this field type may not be available in
+       other curses implementations.

RETURN VALUE

-       The  functions  field_type  and  field_arg  return  NULL on error.  The
+       The functions field_type and  field_arg  return  NULL  on  error.   The
        function set_field_type returns one of the following:
 
        E_OK The routine succeeded.
@@ -214,7 +216,7 @@

PORTABILITY

-       These  routines  emulate  the  System  V  forms library.  They were not
+       These routines emulate the System  V  forms  library.   They  were  not
        supported on Version 7 or BSD versions.
 
 
@@ -224,7 +226,7 @@
 
 
 
-ncurses 6.4                       2023-07-01         form_field_validation(3x)
+ncurses 6.4                       2023-09-16         form_field_validation(3x)

field_arg
field_type

set_field_type
-
Predefined types
+

+ +
PREDEFINED TYPES +
+
TYPE_ALNUM
+
TYPE_ALPHA
+
TYPE_ENUM
+
TYPE_INTEGER
+
TYPE_NUMERIC
+
TYPE_REGEXP
+
TYPE_IPV4

RETURN VALUE
diff --git a/doc/html/man/form_fieldtype.3x.html b/doc/html/man/form_fieldtype.3x.html index 5283667d..81dd8686 100644 --- a/doc/html/man/form_fieldtype.3x.html +++ b/doc/html/man/form_fieldtype.3x.html @@ -28,19 +28,19 @@ * sale, use or other dealings in this Software without prior written * * authorization. * **************************************************************************** - * @Id: form_fieldtype.3x,v 1.35 2023/07/01 15:46:10 tom Exp @ + * @Id: form_fieldtype.3x,v 1.38 2023/09/16 23:37:03 tom Exp @ --> -form_fieldtype 3x 2023-07-01 ncurses 6.4 Library calls +form_fieldtype 3x 2023-09-16 ncurses 6.4 Library calls -
form_fieldtype 3x 2023-07-01 ncurses 6.4 Library calls
+
form_fieldtype 3x 2023-09-16 ncurses 6.4 Library calls

form_fieldtype(3x) Library calls form_fieldtype(3x) @@ -189,7 +189,7 @@ -ncurses 6.4 2023-07-01 form_fieldtype(3x) +ncurses 6.4 2023-09-16 form_fieldtype(3x)

diff --git a/doc/html/man/form_hook.3x.html b/doc/html/man/form_hook.3x.html index 85f7a366..02ad2a13 100644 --- a/doc/html/man/form_hook.3x.html +++ b/doc/html/man/form_hook.3x.html @@ -28,19 +28,19 @@ * sale, use or other dealings in this Software without prior written * * authorization. * **************************************************************************** - * @Id: form_hook.3x,v 1.23 2023/07/01 15:46:10 tom Exp @ + * @Id: form_hook.3x,v 1.25 2023/09/16 23:37:03 tom Exp @ --> -form_hook 3x 2023-07-01 ncurses 6.4 Library calls +form_hook 3x 2023-09-16 ncurses 6.4 Library calls -
form_hook 3x 2023-07-01 ncurses 6.4 Library calls
+
form_hook 3x 2023-09-16 ncurses 6.4 Library calls

form_hook(3x) Library calls form_hook(3x) @@ -72,23 +72,45 @@ various points in the automatic processing of input event codes by form_driver. - The function set_field_init sets a hook to be called at form-post time - and each time the selected field changes (after the change). - field_init returns the current field init hook, if any (NULL if there - is no such hook). - The function set_field_term sets a hook to be called at form-unpost - time and each time the selected field changes (before the change). - field_term returns the current field term hook, if any (NULL if there - is no such hook). +
set_field_init
+ sets a hook to be called at form-post time and each time the selected + field changes (after the change). - The function set_form_init sets a hook to be called at form-post time - and just after a page change once it is posted. form_init returns the - current form init hook, if any (NULL if there is no such hook). - The function set_form_term sets a hook to be called at form-unpost time - and just before a page change once it is posted. form_init returns the - current form term hook, if any (NULL if there is no such hook). +
field_init
+ returns the current field init hook, if any (NULL if there is no such + hook). + + +
set_field_term
+ sets a hook to be called at form-unpost time and each time the selected + field changes (before the change). + + +
field_term
+ returns the current field term hook, if any (NULL if there is no such + hook). + + +
set_form_init
+ sets a hook to be called at form-post time and just after a page change + once it is posted. + + +
form_init
+ returns the current form init hook, if any (NULL if there is no such + hook). + + +
set_form_term
+ sets a hook to be called at form-unpost time and just before a page + change once it is posted. + + +
form_init
+ returns the current form term hook, if any (NULL if there is no such + hook).
RETURN VALUE
@@ -121,13 +143,24 @@ -ncurses 6.4 2023-07-01 form_hook(3x) +ncurses 6.4 2023-09-16 form_hook(3x)

NAME

SYNOPSIS
-
DESCRIPTION
+
DESCRIPTION +
+
set_field_init
+
field_init
+
set_field_term
+
field_term
+
set_form_init
+
form_init
+
set_form_term
+
form_init
+
+

RETURN VALUE

SEE ALSO

NOTES
diff --git a/doc/html/man/form_new.3x.html b/doc/html/man/form_new.3x.html index 02fd9616..3ee01b6e 100644 --- a/doc/html/man/form_new.3x.html +++ b/doc/html/man/form_new.3x.html @@ -28,19 +28,19 @@ * sale, use or other dealings in this Software without prior written * * authorization. * **************************************************************************** - * @Id: form_new.3x,v 1.22 2023/07/01 15:46:10 tom Exp @ + * @Id: form_new.3x,v 1.24 2023/09/16 23:37:03 tom Exp @ --> -form_new 3x 2023-07-01 ncurses 6.4 Library calls +form_new 3x 2023-09-16 ncurses 6.4 Library calls -
form_new 3x 2023-07-01 ncurses 6.4 Library calls
+
form_new 3x 2023-09-16 ncurses 6.4 Library calls

form_new(3x) Library calls form_new(3x) @@ -112,7 +112,7 @@ -ncurses 6.4 2023-07-01 form_new(3x) +ncurses 6.4 2023-09-16 form_new(3x)

diff --git a/doc/html/man/form_new_page.3x.html b/doc/html/man/form_new_page.3x.html index 3f3ccbee..612ad960 100644 --- a/doc/html/man/form_new_page.3x.html +++ b/doc/html/man/form_new_page.3x.html @@ -28,19 +28,19 @@ * sale, use or other dealings in this Software without prior written * * authorization. * **************************************************************************** - * @Id: form_new_page.3x,v 1.24 2023/07/01 15:46:10 tom Exp @ + * @Id: form_new_page.3x,v 1.26 2023/09/16 23:37:03 tom Exp @ --> -form_new_page 3x 2023-07-01 ncurses 6.4 Library calls +form_new_page 3x 2023-09-16 ncurses 6.4 Library calls -
form_new_page 3x 2023-07-01 ncurses 6.4 Library calls
+
form_new_page 3x 2023-09-16 ncurses 6.4 Library calls

form_new_page(3x) Library calls form_new_page(3x) @@ -98,7 +98,7 @@ -ncurses 6.4 2023-07-01 form_new_page(3x) +ncurses 6.4 2023-09-16 form_new_page(3x)

diff --git a/doc/html/man/form_opts.3x.html b/doc/html/man/form_opts.3x.html index c369c127..add4dee1 100644 --- a/doc/html/man/form_opts.3x.html +++ b/doc/html/man/form_opts.3x.html @@ -28,19 +28,19 @@ * sale, use or other dealings in this Software without prior written * * authorization. * **************************************************************************** - * @Id: form_opts.3x,v 1.24 2023/07/01 15:46:10 tom Exp @ + * @Id: form_opts.3x,v 1.26 2023/09/16 23:37:03 tom Exp @ --> -form_opts 3x 2023-07-01 ncurses 6.4 Library calls +form_opts 3x 2023-09-16 ncurses 6.4 Library calls -
form_opts 3x 2023-07-01 ncurses 6.4 Library calls
+
form_opts 3x 2023-09-16 ncurses 6.4 Library calls

form_opts(3x) Library calls form_opts(3x) @@ -114,7 +114,7 @@ -ncurses 6.4 2023-07-01 form_opts(3x) +ncurses 6.4 2023-09-16 form_opts(3x)

diff --git a/doc/html/man/form_page.3x.html b/doc/html/man/form_page.3x.html index 4d465e0d..da7ef450 100644 --- a/doc/html/man/form_page.3x.html +++ b/doc/html/man/form_page.3x.html @@ -28,19 +28,19 @@ * sale, use or other dealings in this Software without prior written * * authorization. * **************************************************************************** - * @Id: form_page.3x,v 1.26 2023/07/01 15:46:10 tom Exp @ + * @Id: form_page.3x,v 1.28 2023/09/16 23:37:03 tom Exp @ --> -form_page 3x 2023-07-01 ncurses 6.4 Library calls +form_page 3x 2023-09-16 ncurses 6.4 Library calls -
form_page 3x 2023-07-01 ncurses 6.4 Library calls
+
form_page 3x 2023-09-16 ncurses 6.4 Library calls

form_page(3x) Library calls form_page(3x) @@ -126,7 +126,7 @@ -ncurses 6.4 2023-07-01 form_page(3x) +ncurses 6.4 2023-09-16 form_page(3x)

diff --git a/doc/html/man/form_post.3x.html b/doc/html/man/form_post.3x.html index 694b108a..5a531caf 100644 --- a/doc/html/man/form_post.3x.html +++ b/doc/html/man/form_post.3x.html @@ -28,19 +28,19 @@ * sale, use or other dealings in this Software without prior written * * authorization. * **************************************************************************** - * @Id: form_post.3x,v 1.23 2023/07/01 15:46:10 tom Exp @ + * @Id: form_post.3x,v 1.25 2023/09/16 23:37:03 tom Exp @ --> -form_post 3x 2023-07-01 ncurses 6.4 Library calls +form_post 3x 2023-09-16 ncurses 6.4 Library calls -
form_post 3x 2023-07-01 ncurses 6.4 Library calls
+
form_post 3x 2023-09-16 ncurses 6.4 Library calls

form_post(3x) Library calls form_post(3x) @@ -115,7 +115,7 @@ -ncurses 6.4 2023-07-01 form_post(3x) +ncurses 6.4 2023-09-16 form_post(3x)

diff --git a/doc/html/man/form_requestname.3x.html b/doc/html/man/form_requestname.3x.html index 6a897069..ccd835ab 100644 --- a/doc/html/man/form_requestname.3x.html +++ b/doc/html/man/form_requestname.3x.html @@ -28,19 +28,19 @@ * sale, use or other dealings in this Software without prior written * * authorization. * **************************************************************************** - * @Id: form_requestname.3x,v 1.23 2023/07/01 15:46:10 tom Exp @ + * @Id: form_requestname.3x,v 1.26 2023/09/16 23:37:03 tom Exp @ --> -form_requestname 3x 2023-07-01 ncurses 6.4 Library calls +form_requestname 3x 2023-09-16 ncurses 6.4 Library calls -
form_requestname 3x 2023-07-01 ncurses 6.4 Library calls
+
form_requestname 3x 2023-09-16 ncurses 6.4 Library calls

form_requestname(3x) Library calls form_requestname(3x) @@ -60,16 +60,10 @@
DESCRIPTION
- -
form_request_name
The function form_request_name returns the printable name of a form - request code. - - -
form_request_name_by_name
- The function form_request_by_name searches in the name-table for a - request with the given name and returns its request code. Otherwise - E_NO_MATCH is returned. + request code. The function form_request_by_name searches in the name- + table for a request with the given name and returns its request code. + Otherwise E_NO_MATCH is returned.
RETURN VALUE
@@ -101,18 +95,13 @@ -ncurses 6.4 2023-07-01 form_requestname(3x) +ncurses 6.4 2023-09-16 form_requestname(3x)

NAME

SYNOPSIS
-
DESCRIPTION -
-
form_request_name
-
form_request_name_by_name
-
-
+
DESCRIPTION

RETURN VALUE

SEE ALSO

NOTES
diff --git a/doc/html/man/form_userptr.3x.html b/doc/html/man/form_userptr.3x.html index 35dc1192..9bcc0c27 100644 --- a/doc/html/man/form_userptr.3x.html +++ b/doc/html/man/form_userptr.3x.html @@ -28,19 +28,19 @@ * sale, use or other dealings in this Software without prior written * * authorization. * **************************************************************************** - * @Id: form_userptr.3x,v 1.26 2023/07/01 15:46:10 tom Exp @ + * @Id: form_userptr.3x,v 1.28 2023/09/16 23:37:03 tom Exp @ --> -form_userptr 3x 2023-07-01 ncurses 6.4 Library calls +form_userptr 3x 2023-09-16 ncurses 6.4 Library calls -
form_userptr 3x 2023-07-01 ncurses 6.4 Library calls
+
form_userptr 3x 2023-09-16 ncurses 6.4 Library calls

form_userptr(3x) Library calls form_userptr(3x) @@ -95,7 +95,7 @@ -ncurses 6.4 2023-07-01 form_userptr(3x) +ncurses 6.4 2023-09-16 form_userptr(3x)

diff --git a/doc/html/man/form_variables.3x.html b/doc/html/man/form_variables.3x.html index 5a8e585b..caf1fdce 100644 --- a/doc/html/man/form_variables.3x.html +++ b/doc/html/man/form_variables.3x.html @@ -1,6 +1,6 @@ -form_variables 3x 2021-12-25 ncurses 6.4 Library calls +form_variables 3x 2023-09-16 ncurses 6.4 Library calls -
form_variables 3x 2021-12-25 ncurses 6.4 Library calls
+
form_variables 3x 2023-09-16 ncurses 6.4 Library calls

form_variables(3x) Library calls form_variables(3x) @@ -108,7 +108,7 @@ -ncurses 6.4 2021-12-25 form_variables(3x) +ncurses 6.4 2023-09-16 form_variables(3x)

diff --git a/doc/html/man/form_win.3x.html b/doc/html/man/form_win.3x.html index c2b0b040..bae77038 100644 --- a/doc/html/man/form_win.3x.html +++ b/doc/html/man/form_win.3x.html @@ -28,19 +28,19 @@ * sale, use or other dealings in this Software without prior written * * authorization. * **************************************************************************** - * @Id: form_win.3x,v 1.25 2023/07/01 15:46:10 tom Exp @ + * @Id: form_win.3x,v 1.27 2023/09/16 23:37:03 tom Exp @ --> -form_win 3x 2023-07-01 ncurses 6.4 Library calls +form_win 3x 2023-09-16 ncurses 6.4 Library calls -
form_win 3x 2023-07-01 ncurses 6.4 Library calls
+
form_win 3x 2023-09-16 ncurses 6.4 Library calls

form_win(3x) Library calls form_win(3x) @@ -120,7 +120,7 @@ -ncurses 6.4 2023-07-01 form_win(3x) +ncurses 6.4 2023-09-16 form_win(3x)

diff --git a/doc/html/man/infocmp.1m.html b/doc/html/man/infocmp.1m.html index 2abfabee..60622bdf 100644 --- a/doc/html/man/infocmp.1m.html +++ b/doc/html/man/infocmp.1m.html @@ -28,19 +28,19 @@ * sale, use or other dealings in this Software without prior written * * authorization. * **************************************************************************** - * @Id: infocmp.1m,v 1.90 2023/09/09 21:14:05 tom Exp @ + * @Id: infocmp.1m,v 1.92 2023/09/16 23:37:03 tom Exp @ --> -infocmp 1m 2023-09-09 ncurses 6.4 User commands +infocmp 1m 2023-09-16 ncurses 6.4 User commands -
infocmp 1m 2023-09-09 ncurses 6.4 User commands
+
infocmp 1m 2023-09-16 ncurses 6.4 User commands

infocmp(1m) User commands infocmp(1m) @@ -522,7 +522,7 @@ https://invisible-island.net/ncurses/tctest.html - This describes ncurses version 6.4 (patch 20230909). + This describes ncurses version 6.4 (patch 20230917).
AUTHOR
@@ -531,7 +531,7 @@ -ncurses 6.4 2023-09-09 infocmp(1m) +ncurses 6.4 2023-09-16 infocmp(1m)

diff --git a/doc/html/man/infotocap.1m.html b/doc/html/man/infotocap.1m.html index 4b794ec2..32130894 100644 --- a/doc/html/man/infotocap.1m.html +++ b/doc/html/man/infotocap.1m.html @@ -1,7 +1,7 @@ -infotocap 1m 2022-02-12 ncurses 6.4 User commands +infotocap 1m 2023-09-16 ncurses 6.4 User commands -
infotocap 1m 2022-02-12 ncurses 6.4 User commands
+
infotocap 1m 2023-09-16 ncurses 6.4 User commands

infotocap(1m) User commands infotocap(1m) @@ -91,7 +91,7 @@
SEE ALSO
infocmp(1m), tic(1m), curses(3x), terminfo(5) - This describes ncurses version 6.4 (patch 20230909). + This describes ncurses version 6.4 (patch 20230917).
AUTHOR
@@ -100,7 +100,7 @@ -ncurses 6.4 2022-02-12 infotocap(1m) +ncurses 6.4 2023-09-16 infotocap(1m)

diff --git a/doc/html/man/key_defined.3x.html b/doc/html/man/key_defined.3x.html index f09018c5..a2f601a0 100644 --- a/doc/html/man/key_defined.3x.html +++ b/doc/html/man/key_defined.3x.html @@ -1,6 +1,6 @@ -key_defined 3x 2022-02-12 ncurses 6.4 Library calls +key_defined 3x 2023-09-16 ncurses 6.4 Library calls -
key_defined 3x 2022-02-12 ncurses 6.4 Library calls
+
key_defined 3x 2023-09-16 ncurses 6.4 Library calls

key_defined(3x) Library calls key_defined(3x) @@ -48,7 +48,7 @@
NAME
- key_defined - check if a keycode is defined + key_defined - test whether a curses keycode is defined
SYNOPSIS
@@ -69,9 +69,9 @@
PORTABILITY
- These routines are specific to ncurses. They were not supported on - Version 7, BSD or System V implementations. It is recommended that any - code depending on them be conditioned using NCURSES_VERSION. + This routine is specific to ncurses. It was not supported on Version + 7, BSD or System V implementations. It is recommended that any code + depending on them be conditioned using NCURSES_VERSION.
SEE ALSO
@@ -83,7 +83,7 @@ -ncurses 6.4 2022-02-12 key_defined(3x) +ncurses 6.4 2023-09-16 key_defined(3x)

diff --git a/doc/html/man/keybound.3x.html b/doc/html/man/keybound.3x.html index 2f6d6584..5d0bdb34 100644 --- a/doc/html/man/keybound.3x.html +++ b/doc/html/man/keybound.3x.html @@ -1,6 +1,6 @@ -keybound 3x 2022-02-12 ncurses 6.4 Library calls +keybound 3x 2023-09-16 ncurses 6.4 Library calls -
keybound 3x 2022-02-12 ncurses 6.4 Library calls
+
keybound 3x 2023-09-16 ncurses 6.4 Library calls

keybound(3x) Library calls keybound(3x) @@ -48,7 +48,7 @@
NAME
- keybound - return definition of keycode + keybound - get definition of curses keycode
SYNOPSIS
@@ -72,9 +72,9 @@
PORTABILITY
- These routines are specific to ncurses. They were not supported on - Version 7, BSD or System V implementations. It is recommended that any - code depending on them be conditioned using NCURSES_VERSION. + This routine is specific to ncurses. It was not supported on Version + 7, BSD or System V implementations. It is recommended that any code + depending on them be conditioned using NCURSES_VERSION.
SEE ALSO
@@ -86,7 +86,7 @@ -ncurses 6.4 2022-02-12 keybound(3x) +ncurses 6.4 2023-09-16 keybound(3x)

diff --git a/doc/html/man/keyok.3x.html b/doc/html/man/keyok.3x.html index df0e4f23..dce2a0a0 100644 --- a/doc/html/man/keyok.3x.html +++ b/doc/html/man/keyok.3x.html @@ -1,6 +1,6 @@ -keyok 3x 2022-02-12 ncurses 6.4 Library calls +keyok 3x 2023-09-16 ncurses 6.4 Library calls -
keyok 3x 2022-02-12 ncurses 6.4 Library calls
+
keyok 3x 2023-09-16 ncurses 6.4 Library calls

keyok(3x) Library calls keyok(3x) @@ -48,7 +48,7 @@
NAME
- keyok - enable or disable a keycode + keyok - enable or disable a curses keycode
SYNOPSIS
@@ -71,9 +71,9 @@
PORTABILITY
- These routines are specific to ncurses. They were not supported on - Version 7, BSD or System V implementations. It is recommended that any - code depending on them be conditioned using NCURSES_VERSION. + This routine is specific to ncurses. It was not supported on Version + 7, BSD or System V implementations. It is recommended that any code + depending on them be conditioned using NCURSES_VERSION.
SEE ALSO
@@ -85,7 +85,7 @@ -ncurses 6.4 2022-02-12 keyok(3x) +ncurses 6.4 2023-09-16 keyok(3x)

diff --git a/doc/html/man/legacy_coding.3x.html b/doc/html/man/legacy_coding.3x.html index 8b019b8e..433c53a6 100644 --- a/doc/html/man/legacy_coding.3x.html +++ b/doc/html/man/legacy_coding.3x.html @@ -1,6 +1,6 @@ -legacy_coding 3x 2022-02-12 ncurses 6.4 Library calls +legacy_coding 3x 2023-09-16 ncurses 6.4 Library calls -
legacy_coding 3x 2022-02-12 ncurses 6.4 Library calls
+
legacy_coding 3x 2023-09-16 ncurses 6.4 Library calls

legacy_coding(3x) Library calls legacy_coding(3x) @@ -48,7 +48,7 @@
NAME
- use_legacy_coding - override locale-encoding checks + use_legacy_coding - override curses locale encoding checks
SYNOPSIS
@@ -98,7 +98,7 @@ -ncurses 6.4 2022-02-12 legacy_coding(3x) +ncurses 6.4 2023-09-16 legacy_coding(3x)

diff --git a/doc/html/man/menu.3x.html b/doc/html/man/menu.3x.html index 6022f6cc..e2eaadc6 100644 --- a/doc/html/man/menu.3x.html +++ b/doc/html/man/menu.3x.html @@ -28,19 +28,19 @@ * sale, use or other dealings in this Software without prior written * * authorization. * **************************************************************************** - * @Id: menu.3x,v 1.34 2023/08/19 20:39:40 tom Exp @ + * @Id: menu.3x,v 1.36 2023/09/16 23:38:39 tom Exp @ --> -menu 3x 2023-08-19 ncurses 6.4 Library calls +menu 3x 2023-09-16 ncurses 6.4 Library calls -
menu 3x 2023-08-19 ncurses 6.4 Library calls
+
menu 3x 2023-09-16 ncurses 6.4 Library calls

menu(3x) Library calls menu(3x) @@ -223,11 +223,11 @@ curses(3x) and related pages whose names begin "menu_" for detailed descriptions of the entry points. - This describes ncurses version 6.4 (patch 20230909). + This describes ncurses version 6.4 (patch 20230917). -ncurses 6.4 2023-08-19 menu(3x) +ncurses 6.4 2023-09-16 menu(3x)

diff --git a/doc/html/man/menu_attributes.3x.html b/doc/html/man/menu_attributes.3x.html index 7361da6f..67e11b04 100644 --- a/doc/html/man/menu_attributes.3x.html +++ b/doc/html/man/menu_attributes.3x.html @@ -28,19 +28,19 @@ * sale, use or other dealings in this Software without prior written * * authorization. * **************************************************************************** - * @Id: menu_attributes.3x,v 1.26 2023/07/01 15:46:10 tom Exp @ + * @Id: menu_attributes.3x,v 1.28 2023/09/16 23:38:39 tom Exp @ --> -menu_attributes 3x 2023-07-01 ncurses 6.4 Library calls +menu_attributes 3x 2023-09-16 ncurses 6.4 Library calls -
menu_attributes 3x 2023-07-01 ncurses 6.4 Library calls
+
menu_attributes 3x 2023-09-16 ncurses 6.4 Library calls

menu_attributes(3x) Library calls menu_attributes(3x) @@ -122,7 +122,7 @@ -ncurses 6.4 2023-07-01 menu_attributes(3x) +ncurses 6.4 2023-09-16 menu_attributes(3x)

diff --git a/doc/html/man/menu_cursor.3x.html b/doc/html/man/menu_cursor.3x.html index fa0f7f87..7fbc6368 100644 --- a/doc/html/man/menu_cursor.3x.html +++ b/doc/html/man/menu_cursor.3x.html @@ -28,19 +28,19 @@ * sale, use or other dealings in this Software without prior written * * authorization. * **************************************************************************** - * @Id: menu_cursor.3x,v 1.20 2023/07/01 15:46:10 tom Exp @ + * @Id: menu_cursor.3x,v 1.22 2023/09/16 23:38:39 tom Exp @ --> -menu_cursor 3x 2023-07-01 ncurses 6.4 Library calls +menu_cursor 3x 2023-09-16 ncurses 6.4 Library calls -
menu_cursor 3x 2023-07-01 ncurses 6.4 Library calls
+
menu_cursor 3x 2023-09-16 ncurses 6.4 Library calls

menu_cursor(3x) Library calls menu_cursor(3x) @@ -99,7 +99,7 @@ -ncurses 6.4 2023-07-01 menu_cursor(3x) +ncurses 6.4 2023-09-16 menu_cursor(3x)

diff --git a/doc/html/man/menu_driver.3x.html b/doc/html/man/menu_driver.3x.html index bb18751d..9331ee28 100644 --- a/doc/html/man/menu_driver.3x.html +++ b/doc/html/man/menu_driver.3x.html @@ -27,19 +27,19 @@ * sale, use or other dealings in this Software without prior written * * authorization. * **************************************************************************** - * @Id: menu_driver.3x,v 1.35 2023/07/01 15:46:10 tom Exp @ + * @Id: menu_driver.3x,v 1.37 2023/09/16 23:38:39 tom Exp @ --> -menu_driver 3x 2023-07-01 ncurses 6.4 Library calls +menu_driver 3x 2023-09-16 ncurses 6.4 Library calls -
menu_driver 3x 2023-07-01 ncurses 6.4 Library calls
+
menu_driver 3x 2023-09-16 ncurses 6.4 Library calls

menu_driver(3x) Library calls menu_driver(3x) @@ -228,7 +228,7 @@ -ncurses 6.4 2023-07-01 menu_driver(3x) +ncurses 6.4 2023-09-16 menu_driver(3x)

diff --git a/doc/html/man/menu_format.3x.html b/doc/html/man/menu_format.3x.html index ce74e39f..5d358859 100644 --- a/doc/html/man/menu_format.3x.html +++ b/doc/html/man/menu_format.3x.html @@ -28,19 +28,19 @@ * sale, use or other dealings in this Software without prior written * * authorization. * **************************************************************************** - * @Id: menu_format.3x,v 1.25 2023/07/01 15:46:10 tom Exp @ + * @Id: menu_format.3x,v 1.27 2023/09/16 23:38:39 tom Exp @ --> -menu_format 3x 2023-07-01 ncurses 6.4 Library calls +menu_format 3x 2023-09-16 ncurses 6.4 Library calls -
menu_format 3x 2023-07-01 ncurses 6.4 Library calls
+
menu_format 3x 2023-09-16 ncurses 6.4 Library calls

menu_format(3x) Library calls menu_format(3x) @@ -112,7 +112,7 @@ -ncurses 6.4 2023-07-01 menu_format(3x) +ncurses 6.4 2023-09-16 menu_format(3x)

diff --git a/doc/html/man/menu_hook.3x.html b/doc/html/man/menu_hook.3x.html index de38b3e6..435cac1f 100644 --- a/doc/html/man/menu_hook.3x.html +++ b/doc/html/man/menu_hook.3x.html @@ -28,19 +28,19 @@ * sale, use or other dealings in this Software without prior written * * authorization. * **************************************************************************** - * @Id: menu_hook.3x,v 1.22 2023/07/01 15:46:10 tom Exp @ + * @Id: menu_hook.3x,v 1.24 2023/09/16 23:38:39 tom Exp @ --> -menu_hook 3x 2023-07-01 ncurses 6.4 Library calls +menu_hook 3x 2023-09-16 ncurses 6.4 Library calls -
menu_hook 3x 2023-07-01 ncurses 6.4 Library calls
+
menu_hook 3x 2023-09-16 ncurses 6.4 Library calls

menu_hook(3x) Library calls menu_hook(3x) @@ -123,7 +123,7 @@ -ncurses 6.4 2023-07-01 menu_hook(3x) +ncurses 6.4 2023-09-16 menu_hook(3x)

diff --git a/doc/html/man/menu_items.3x.html b/doc/html/man/menu_items.3x.html index 875a18a9..b7f020ea 100644 --- a/doc/html/man/menu_items.3x.html +++ b/doc/html/man/menu_items.3x.html @@ -28,19 +28,19 @@ * sale, use or other dealings in this Software without prior written * * authorization. * **************************************************************************** - * @Id: menu_items.3x,v 1.24 2023/07/01 15:46:10 tom Exp @ + * @Id: menu_items.3x,v 1.26 2023/09/16 23:38:39 tom Exp @ --> -menu_items 3x 2023-07-01 ncurses 6.4 Library calls +menu_items 3x 2023-09-16 ncurses 6.4 Library calls -
menu_items 3x 2023-07-01 ncurses 6.4 Library calls
+
menu_items 3x 2023-09-16 ncurses 6.4 Library calls

menu_items(3x) Library calls menu_items(3x) @@ -117,7 +117,7 @@ -ncurses 6.4 2023-07-01 menu_items(3x) +ncurses 6.4 2023-09-16 menu_items(3x)

diff --git a/doc/html/man/menu_mark.3x.html b/doc/html/man/menu_mark.3x.html index 23f07cf7..8587aaea 100644 --- a/doc/html/man/menu_mark.3x.html +++ b/doc/html/man/menu_mark.3x.html @@ -28,19 +28,19 @@ * sale, use or other dealings in this Software without prior written * * authorization. * **************************************************************************** - * @Id: menu_mark.3x,v 1.25 2023/07/01 15:46:10 tom Exp @ + * @Id: menu_mark.3x,v 1.27 2023/09/16 23:38:39 tom Exp @ --> -menu_mark 3x 2023-07-01 ncurses 6.4 Library calls +menu_mark 3x 2023-09-16 ncurses 6.4 Library calls -
menu_mark 3x 2023-07-01 ncurses 6.4 Library calls
+
menu_mark 3x 2023-09-16 ncurses 6.4 Library calls

menu_mark(3x) Library calls menu_mark(3x) @@ -110,7 +110,7 @@ -ncurses 6.4 2023-07-01 menu_mark(3x) +ncurses 6.4 2023-09-16 menu_mark(3x)

diff --git a/doc/html/man/menu_new.3x.html b/doc/html/man/menu_new.3x.html index 2a2c9df8..434a29fc 100644 --- a/doc/html/man/menu_new.3x.html +++ b/doc/html/man/menu_new.3x.html @@ -28,19 +28,19 @@ * sale, use or other dealings in this Software without prior written * * authorization. * **************************************************************************** - * @Id: menu_new.3x,v 1.25 2023/07/01 15:46:10 tom Exp @ + * @Id: menu_new.3x,v 1.27 2023/09/16 23:38:39 tom Exp @ --> -menu_new 3x 2023-07-01 ncurses 6.4 Library calls +menu_new 3x 2023-09-16 ncurses 6.4 Library calls -
menu_new 3x 2023-07-01 ncurses 6.4 Library calls
+
menu_new 3x 2023-09-16 ncurses 6.4 Library calls

menu_new(3x) Library calls menu_new(3x) @@ -110,7 +110,7 @@ -ncurses 6.4 2023-07-01 menu_new(3x) +ncurses 6.4 2023-09-16 menu_new(3x)

diff --git a/doc/html/man/menu_opts.3x.html b/doc/html/man/menu_opts.3x.html index f0a06a25..44db0f0b 100644 --- a/doc/html/man/menu_opts.3x.html +++ b/doc/html/man/menu_opts.3x.html @@ -28,19 +28,19 @@ * sale, use or other dealings in this Software without prior written * * authorization. * **************************************************************************** - * @Id: menu_opts.3x,v 1.25 2023/07/01 15:46:10 tom Exp @ + * @Id: menu_opts.3x,v 1.27 2023/09/16 23:38:39 tom Exp @ --> -menu_opts 3x 2023-07-01 ncurses 6.4 Library calls +menu_opts 3x 2023-09-16 ncurses 6.4 Library calls -
menu_opts 3x 2023-07-01 ncurses 6.4 Library calls
+
menu_opts 3x 2023-09-16 ncurses 6.4 Library calls

menu_opts(3x) Library calls menu_opts(3x) @@ -134,7 +134,7 @@ -ncurses 6.4 2023-07-01 menu_opts(3x) +ncurses 6.4 2023-09-16 menu_opts(3x)

diff --git a/doc/html/man/menu_pattern.3x.html b/doc/html/man/menu_pattern.3x.html index 389a4b4d..6c278fa8 100644 --- a/doc/html/man/menu_pattern.3x.html +++ b/doc/html/man/menu_pattern.3x.html @@ -27,19 +27,19 @@ * sale, use or other dealings in this Software without prior written * * authorization. * **************************************************************************** - * @Id: menu_pattern.3x,v 1.28 2023/07/01 15:46:10 tom Exp @ + * @Id: menu_pattern.3x,v 1.30 2023/09/16 23:38:39 tom Exp @ --> -menu_pattern 3x 2023-07-01 ncurses 6.4 Library calls +menu_pattern 3x 2023-09-16 ncurses 6.4 Library calls -
menu_pattern 3x 2023-07-01 ncurses 6.4 Library calls
+
menu_pattern 3x 2023-09-16 ncurses 6.4 Library calls

menu_pattern(3x) Library calls menu_pattern(3x) @@ -114,7 +114,7 @@ -ncurses 6.4 2023-07-01 menu_pattern(3x) +ncurses 6.4 2023-09-16 menu_pattern(3x)

diff --git a/doc/html/man/menu_post.3x.html b/doc/html/man/menu_post.3x.html index 1ff1d35e..4905084d 100644 --- a/doc/html/man/menu_post.3x.html +++ b/doc/html/man/menu_post.3x.html @@ -28,19 +28,19 @@ * sale, use or other dealings in this Software without prior written * * authorization. * **************************************************************************** - * @Id: menu_post.3x,v 1.26 2023/07/01 15:46:10 tom Exp @ + * @Id: menu_post.3x,v 1.28 2023/09/16 23:38:39 tom Exp @ --> -menu_post 3x 2023-07-01 ncurses 6.4 Library calls +menu_post 3x 2023-09-16 ncurses 6.4 Library calls -
menu_post 3x 2023-07-01 ncurses 6.4 Library calls
+
menu_post 3x 2023-09-16 ncurses 6.4 Library calls

menu_post(3x) Library calls menu_post(3x) @@ -117,7 +117,7 @@ -ncurses 6.4 2023-07-01 menu_post(3x) +ncurses 6.4 2023-09-16 menu_post(3x)

diff --git a/doc/html/man/menu_requestname.3x.html b/doc/html/man/menu_requestname.3x.html index 91bc208f..20b1e93a 100644 --- a/doc/html/man/menu_requestname.3x.html +++ b/doc/html/man/menu_requestname.3x.html @@ -28,19 +28,19 @@ * sale, use or other dealings in this Software without prior written * * authorization. * **************************************************************************** - * @Id: menu_requestname.3x,v 1.22 2023/07/01 15:46:10 tom Exp @ + * @Id: menu_requestname.3x,v 1.24 2023/09/16 23:38:39 tom Exp @ --> -menu_requestname 3x 2023-07-01 ncurses 6.4 Library calls +menu_requestname 3x 2023-09-16 ncurses 6.4 Library calls -
menu_requestname 3x 2023-07-01 ncurses 6.4 Library calls
+
menu_requestname 3x 2023-09-16 ncurses 6.4 Library calls

menu_requestname(3x) Library calls menu_requestname(3x) @@ -95,7 +95,7 @@ -ncurses 6.4 2023-07-01 menu_requestname(3x) +ncurses 6.4 2023-09-16 menu_requestname(3x)

diff --git a/doc/html/man/menu_spacing.3x.html b/doc/html/man/menu_spacing.3x.html index 13dc2e8a..e55b60f4 100644 --- a/doc/html/man/menu_spacing.3x.html +++ b/doc/html/man/menu_spacing.3x.html @@ -28,19 +28,19 @@ * sale, use or other dealings in this Software without prior written * * authorization. * **************************************************************************** - * @Id: menu_spacing.3x,v 1.24 2023/07/01 15:46:10 tom Exp @ + * @Id: menu_spacing.3x,v 1.26 2023/09/16 23:38:39 tom Exp @ --> -menu_spacing 3x 2023-07-01 ncurses 6.4 Library calls +menu_spacing 3x 2023-09-16 ncurses 6.4 Library calls -
menu_spacing 3x 2023-07-01 ncurses 6.4 Library calls
+
menu_spacing 3x 2023-09-16 ncurses 6.4 Library calls

menu_spacing(3x) Library calls menu_spacing(3x) @@ -109,7 +109,7 @@ -ncurses 6.4 2023-07-01 menu_spacing(3x) +ncurses 6.4 2023-09-16 menu_spacing(3x)

diff --git a/doc/html/man/menu_userptr.3x.html b/doc/html/man/menu_userptr.3x.html index 996adb1f..bdb5db21 100644 --- a/doc/html/man/menu_userptr.3x.html +++ b/doc/html/man/menu_userptr.3x.html @@ -28,19 +28,19 @@ * sale, use or other dealings in this Software without prior written * * authorization. * **************************************************************************** - * @Id: menu_userptr.3x,v 1.23 2023/07/01 15:46:10 tom Exp @ + * @Id: menu_userptr.3x,v 1.25 2023/09/16 23:38:39 tom Exp @ --> -menu_userptr 3x 2023-07-01 ncurses 6.4 Library calls +menu_userptr 3x 2023-09-16 ncurses 6.4 Library calls -
menu_userptr 3x 2023-07-01 ncurses 6.4 Library calls
+
menu_userptr 3x 2023-09-16 ncurses 6.4 Library calls

menu_userptr(3x) Library calls menu_userptr(3x) @@ -95,7 +95,7 @@ -ncurses 6.4 2023-07-01 menu_userptr(3x) +ncurses 6.4 2023-09-16 menu_userptr(3x)

diff --git a/doc/html/man/menu_win.3x.html b/doc/html/man/menu_win.3x.html index 7a661c28..76d98426 100644 --- a/doc/html/man/menu_win.3x.html +++ b/doc/html/man/menu_win.3x.html @@ -28,19 +28,19 @@ * sale, use or other dealings in this Software without prior written * * authorization. * **************************************************************************** - * @Id: menu_win.3x,v 1.22 2023/07/01 15:46:10 tom Exp @ + * @Id: menu_win.3x,v 1.24 2023/09/16 23:38:39 tom Exp @ --> -menu_win 3x 2023-07-01 ncurses 6.4 Library calls +menu_win 3x 2023-09-16 ncurses 6.4 Library calls -
menu_win 3x 2023-07-01 ncurses 6.4 Library calls
+
menu_win 3x 2023-09-16 ncurses 6.4 Library calls

menu_win(3x) Library calls menu_win(3x) @@ -120,7 +120,7 @@ -ncurses 6.4 2023-07-01 menu_win(3x) +ncurses 6.4 2023-09-16 menu_win(3x)

diff --git a/doc/html/man/mitem_current.3x.html b/doc/html/man/mitem_current.3x.html index 05ac7266..2b24b954 100644 --- a/doc/html/man/mitem_current.3x.html +++ b/doc/html/man/mitem_current.3x.html @@ -28,19 +28,19 @@ * sale, use or other dealings in this Software without prior written * * authorization. * **************************************************************************** - * @Id: mitem_current.3x,v 1.27 2023/07/01 15:46:10 tom Exp @ + * @Id: mitem_current.3x,v 1.29 2023/09/16 23:38:39 tom Exp @ --> -mitem_current 3x 2023-07-01 ncurses 6.4 Library calls +mitem_current 3x 2023-09-16 ncurses 6.4 Library calls -
mitem_current 3x 2023-07-01 ncurses 6.4 Library calls
+
mitem_current 3x 2023-09-16 ncurses 6.4 Library calls

mitem_current(3x) Library calls mitem_current(3x) @@ -125,7 +125,7 @@ -ncurses 6.4 2023-07-01 mitem_current(3x) +ncurses 6.4 2023-09-16 mitem_current(3x)

diff --git a/doc/html/man/mitem_name.3x.html b/doc/html/man/mitem_name.3x.html index de34e9a7..2230a55c 100644 --- a/doc/html/man/mitem_name.3x.html +++ b/doc/html/man/mitem_name.3x.html @@ -28,19 +28,19 @@ * sale, use or other dealings in this Software without prior written * * authorization. * **************************************************************************** - * @Id: mitem_name.3x,v 1.21 2023/07/01 15:46:10 tom Exp @ + * @Id: mitem_name.3x,v 1.23 2023/09/16 23:38:39 tom Exp @ --> -mitem_name 3x 2023-07-01 ncurses 6.4 Library calls +mitem_name 3x 2023-09-16 ncurses 6.4 Library calls -
mitem_name 3x 2023-07-01 ncurses 6.4 Library calls
+
mitem_name 3x 2023-09-16 ncurses 6.4 Library calls

mitem_name(3x) Library calls mitem_name(3x) @@ -89,7 +89,7 @@ -ncurses 6.4 2023-07-01 mitem_name(3x) +ncurses 6.4 2023-09-16 mitem_name(3x)

diff --git a/doc/html/man/mitem_new.3x.html b/doc/html/man/mitem_new.3x.html index 6b1605c3..78df15f4 100644 --- a/doc/html/man/mitem_new.3x.html +++ b/doc/html/man/mitem_new.3x.html @@ -28,19 +28,19 @@ * sale, use or other dealings in this Software without prior written * * authorization. * **************************************************************************** - * @Id: mitem_new.3x,v 1.26 2023/07/01 15:46:10 tom Exp @ + * @Id: mitem_new.3x,v 1.28 2023/09/16 23:38:39 tom Exp @ --> -mitem_new 3x 2023-07-01 ncurses 6.4 Library calls +mitem_new 3x 2023-09-16 ncurses 6.4 Library calls -
mitem_new 3x 2023-07-01 ncurses 6.4 Library calls
+
mitem_new 3x 2023-09-16 ncurses 6.4 Library calls

mitem_new(3x) Library calls mitem_new(3x) @@ -113,7 +113,7 @@ -ncurses 6.4 2023-07-01 mitem_new(3x) +ncurses 6.4 2023-09-16 mitem_new(3x)

diff --git a/doc/html/man/mitem_opts.3x.html b/doc/html/man/mitem_opts.3x.html index 6149faa6..51fde1c7 100644 --- a/doc/html/man/mitem_opts.3x.html +++ b/doc/html/man/mitem_opts.3x.html @@ -28,19 +28,19 @@ * sale, use or other dealings in this Software without prior written * * authorization. * **************************************************************************** - * @Id: mitem_opts.3x,v 1.23 2023/07/01 15:46:10 tom Exp @ + * @Id: mitem_opts.3x,v 1.25 2023/09/16 23:38:39 tom Exp @ --> -mitem_opts 3x 2023-07-01 ncurses 6.4 Library calls +mitem_opts 3x 2023-09-16 ncurses 6.4 Library calls -
mitem_opts 3x 2023-07-01 ncurses 6.4 Library calls
+
mitem_opts 3x 2023-09-16 ncurses 6.4 Library calls

mitem_opts(3x) Library calls mitem_opts(3x) @@ -108,7 +108,7 @@ -ncurses 6.4 2023-07-01 mitem_opts(3x) +ncurses 6.4 2023-09-16 mitem_opts(3x)

diff --git a/doc/html/man/mitem_userptr.3x.html b/doc/html/man/mitem_userptr.3x.html index b17ccbf2..e2ac6880 100644 --- a/doc/html/man/mitem_userptr.3x.html +++ b/doc/html/man/mitem_userptr.3x.html @@ -28,19 +28,19 @@ * sale, use or other dealings in this Software without prior written * * authorization. * **************************************************************************** - * @Id: mitem_userptr.3x,v 1.24 2023/07/01 15:46:10 tom Exp @ + * @Id: mitem_userptr.3x,v 1.26 2023/09/16 23:38:39 tom Exp @ --> -mitem_userptr 3x 2023-07-01 ncurses 6.4 Library calls +mitem_userptr 3x 2023-09-16 ncurses 6.4 Library calls -
mitem_userptr 3x 2023-07-01 ncurses 6.4 Library calls
+
mitem_userptr 3x 2023-09-16 ncurses 6.4 Library calls

mitem_userptr(3x) Library calls mitem_userptr(3x) @@ -95,7 +95,7 @@ -ncurses 6.4 2023-07-01 mitem_userptr(3x) +ncurses 6.4 2023-09-16 mitem_userptr(3x)

diff --git a/doc/html/man/mitem_value.3x.html b/doc/html/man/mitem_value.3x.html index 3b967ab0..51e5503f 100644 --- a/doc/html/man/mitem_value.3x.html +++ b/doc/html/man/mitem_value.3x.html @@ -27,19 +27,19 @@ * sale, use or other dealings in this Software without prior written * * authorization. * **************************************************************************** - * @Id: mitem_value.3x,v 1.22 2023/07/01 15:46:10 tom Exp @ + * @Id: mitem_value.3x,v 1.24 2023/09/16 23:38:39 tom Exp @ --> -mitem_value 3x 2023-07-01 ncurses 6.4 Library calls +mitem_value 3x 2023-09-16 ncurses 6.4 Library calls -
mitem_value 3x 2023-07-01 ncurses 6.4 Library calls
+
mitem_value 3x 2023-09-16 ncurses 6.4 Library calls

mitem_value(3x) Library calls mitem_value(3x) @@ -99,7 +99,7 @@ -ncurses 6.4 2023-07-01 mitem_value(3x) +ncurses 6.4 2023-09-16 mitem_value(3x)

diff --git a/doc/html/man/mitem_visible.3x.html b/doc/html/man/mitem_visible.3x.html index c695443d..5ddd8bd9 100644 --- a/doc/html/man/mitem_visible.3x.html +++ b/doc/html/man/mitem_visible.3x.html @@ -28,19 +28,19 @@ * sale, use or other dealings in this Software without prior written * * authorization. * **************************************************************************** - * @Id: mitem_visible.3x,v 1.17 2023/07/01 15:46:10 tom Exp @ + * @Id: mitem_visible.3x,v 1.19 2023/09/16 23:38:39 tom Exp @ --> -mitem_visible 3x 2023-07-01 ncurses 6.4 Library calls +mitem_visible 3x 2023-09-16 ncurses 6.4 Library calls -
mitem_visible 3x 2023-07-01 ncurses 6.4 Library calls
+
mitem_visible 3x 2023-09-16 ncurses 6.4 Library calls

mitem_visible(3x) Library calls mitem_visible(3x) @@ -83,7 +83,7 @@ -ncurses 6.4 2023-07-01 mitem_visible(3x) +ncurses 6.4 2023-09-16 mitem_visible(3x)

diff --git a/doc/html/man/ncurses.3x.html b/doc/html/man/ncurses.3x.html index 9142cfa4..59e5689f 100644 --- a/doc/html/man/ncurses.3x.html +++ b/doc/html/man/ncurses.3x.html @@ -28,19 +28,19 @@ * sale, use or other dealings in this Software without prior written * * authorization. * **************************************************************************** - * @Id: ncurses.3x,v 1.167 2023/09/09 21:11:08 tom Exp @ + * @Id: ncurses.3x,v 1.171 2023/09/16 23:38:39 tom Exp @ --> -ncurses 3x 2023-09-09 ncurses 6.4 Library calls +ncurses 3x 2023-09-16 ncurses 6.4 Library calls -
ncurses 3x 2023-09-09 ncurses 6.4 Library calls
+
ncurses 3x 2023-09-16 ncurses 6.4 Library calls

ncurses(3x) Library calls ncurses(3x) @@ -48,7 +48,7 @@
NAME
- ncurses - CRT screen handling and optimization package + ncurses - character-cell terminal interface with optimized output
SYNOPSIS
@@ -60,7 +60,7 @@ method of updating character screens with reasonable optimization. This implementation is "new curses" (ncurses) and is the approved replacement for 4.4BSD classic curses, which has been discontinued. - This describes ncurses version 6.4 (patch 20230909). + This describes ncurses version 6.4 (patch 20230917). The ncurses library emulates the curses library of System V Release 4 UNIX, and XPG4 (X/Open Portability Guide) curses (also known as XSI @@ -1482,7 +1482,7 @@ -ncurses 6.4 2023-09-09 ncurses(3x) +ncurses 6.4 2023-09-16 ncurses(3x)

diff --git a/doc/html/man/ncurses6-config.1.html b/doc/html/man/ncurses6-config.1.html index 974aff84..6994763e 100644 --- a/doc/html/man/ncurses6-config.1.html +++ b/doc/html/man/ncurses6-config.1.html @@ -1,6 +1,6 @@ -ncurses6-config 1 2021-12-25 ncurses 6.4 User commands +ncurses6-config 1 2023-09-17 ncurses 6.4 User commands -
ncurses6-config 1 2021-12-25 ncurses 6.4 User commands
+
ncurses6-config 1 2023-09-17 ncurses 6.4 User commands

ncurses6-config(1) User commands ncurses6-config(1) @@ -47,7 +47,7 @@
NAME
- ncurses6-config - helper script for ncurses libraries + ncurses6-config - helper script for ncurses libraries
SYNOPSIS
@@ -113,11 +113,11 @@
SEE ALSO
curses(3x) - This describes ncurses version 6.4 (patch 20230909). + This describes ncurses version 6.4 (patch 20230917). -ncurses 6.4 2021-12-25 ncurses6-config(1) +ncurses 6.4 2023-09-17 ncurses6-config(1)

diff --git a/doc/html/man/new_pair.3x.html b/doc/html/man/new_pair.3x.html index d55b3c7e..b2c0d209 100644 --- a/doc/html/man/new_pair.3x.html +++ b/doc/html/man/new_pair.3x.html @@ -28,19 +28,19 @@ * authorization. * **************************************************************************** * Author: Thomas E. Dickey - * @Id: new_pair.3x,v 1.26 2023/09/09 21:20:16 tom Exp @ + * @Id: new_pair.3x,v 1.30 2023/09/16 23:38:39 tom Exp @ --> -new_pair 3x 2023-09-09 ncurses 6.4 Library calls +new_pair 3x 2023-09-16 ncurses 6.4 Library calls -
new_pair 3x 2023-09-09 ncurses 6.4 Library calls
+
new_pair 3x 2023-09-16 ncurses 6.4 Library calls

new_pair(3x) Library calls new_pair(3x) @@ -48,7 +48,8 @@
NAME
- alloc_pair, find_pair, free_pair - new curses color-pair functions + alloc_pair, find_pair, free_pair - dynamically allocate curses color + pairs
SYNOPSIS
@@ -61,30 +62,30 @@
DESCRIPTION
These functions are an extension to the curses library. They permit an - application to dynamically allocate a color pair using the - foreground/background colors rather than assign a fixed color pair + application to dynamically allocate a color pair using the + foreground/background colors rather than assign a fixed color pair number, and return an unused pair to the pool. - The number of colors may be related to the number of possible color + The number of colors may be related to the number of possible color pairs for a given terminal, or it may not: - o While almost all terminals allow setting the color attributes - independently, it is unlikely that your terminal allows you to - modify the attributes of a given character cell without rewriting + o While almost all terminals allow setting the color attributes + independently, it is unlikely that your terminal allows you to + modify the attributes of a given character cell without rewriting it. That is, the foreground and background colors are applied as a pair. - o Color pairs are the curses library's way of managing a color - palette on a terminal. If the library does not keep track of the + o Color pairs are the curses library's way of managing a color + palette on a terminal. If the library does not keep track of the combinations of colors which are displayed, it will be inefficient. - o For simple terminal emulators with only a few dozen color - combinations, it is convenient to use the maximum number of + o For simple terminal emulators with only a few dozen color + combinations, it is convenient to use the maximum number of combinations as the limit on color pairs: COLORS * COLORS - o Terminals which support default colors distinct from "ANSI colors" + o Terminals which support default colors distinct from "ANSI colors" add to the possible combinations, producing this total: ( COLORS + 1 ) * ( COLORS + 1 ) @@ -92,43 +93,43 @@ o An application might use up to a few dozen color pairs to implement a predefined color scheme. - Beyond that lies in the realm of programs using the foreground and - background colors for "ASCII art" (or some other non-textual + Beyond that lies in the realm of programs using the foreground and + background colors for "ASCII art" (or some other non-textual application). Also beyond those few dozen pairs, the required size for a table to - represent the combinations grows rapidly with an increasing number + represent the combinations grows rapidly with an increasing number of colors. - These functions allow a developer to let the screen library manage + These functions allow a developer to let the screen library manage color pairs.
alloc_pair
- The alloc_pair function accepts parameters for foreground and - background color, and checks if that color combination is already + The alloc_pair function accepts parameters for foreground and + background color, and checks if that color combination is already associated with a color pair. - o If the combination already exists, alloc_pair returns the existing + o If the combination already exists, alloc_pair returns the existing pair. o If the combination does not exist, alloc_pair allocates a new color pair and returns that. - o If the table fills up, alloc_pair discards the least-recently + o If the table fills up, alloc_pair discards the least-recently allocated entry using free_pair and allocates a new color pair. - All of the color pairs are allocated from a table of possible color - pairs. The size of the table is determined by the terminfo pairs - capability. The table is shared with init_pair; in fact alloc_pair - calls init_pair after updating the ncurses library's fast index to the + All of the color pairs are allocated from a table of possible color + pairs. The size of the table is determined by the terminfo pairs + capability. The table is shared with init_pair; in fact alloc_pair + calls init_pair after updating the ncurses library's fast index to the colors versus color pairs.
find_pair
The find_pair function accepts parameters for foreground and background - color, and checks if that color combination is already associated with - a color pair, returning the pair number if it has been allocated. + color, and checks if that color combination is already associated with + a color pair, returning the pair number if it has been allocated. Otherwise it returns -1. @@ -137,20 +138,20 @@
RETURN VALUE
- The alloc_pair function returns a color pair number in the range 1 - through COLOR_PAIRS-1, unless it encounters an error updating its fast - index to the color pair values, preventing it from allocating a color + The alloc_pair function returns a color pair number in the range 1 + through COLOR_PAIRS-1, unless it encounters an error updating its fast + index to the color pair values, preventing it from allocating a color pair. In that case, it returns -1. - The find_pair function returns a color pair number if the given color + The find_pair function returns a color pair number if the given color combination has been associated with a color pair, or -1 if not. - Likewise, free_pair returns OK unless it encounters an error updating + Likewise, free_pair returns OK unless it encounters an error updating the fast index or if no such color pair is in use.
PORTABILITY
- These routines are specific to ncurses. They were not supported on + These routines are specific to ncurses. They were not supported on Version 7, BSD or System V implementations. It is recommended that any code depending on them be conditioned using NCURSES_VERSION. @@ -164,7 +165,7 @@ -ncurses 6.4 2023-09-09 new_pair(3x) +ncurses 6.4 2023-09-16 new_pair(3x)

diff --git a/doc/html/man/panel.3x.html b/doc/html/man/panel.3x.html index 972eff35..8b8c6d82 100644 --- a/doc/html/man/panel.3x.html +++ b/doc/html/man/panel.3x.html @@ -27,7 +27,7 @@ * sale, use or other dealings in this Software without prior written * * authorization. * **************************************************************************** - * @Id: panel.3x,v 1.48 2023/08/19 21:01:21 tom Exp @ + * @Id: panel.3x,v 1.50 2023/09/16 23:38:39 tom Exp @ * --------- * --------- * --------- @@ -51,12 +51,12 @@ -panel 3x 2023-08-19 ncurses 6.4 Library calls +panel 3x 2023-09-16 ncurses 6.4 Library calls -
panel 3x 2023-08-19 ncurses 6.4 Library calls
+
panel 3x 2023-09-16 ncurses 6.4 Library calls

panel(3x) Library calls panel(3x) @@ -281,7 +281,7 @@
SEE ALSO
curses(3x), curs_variables(3x), - This describes ncurses version 6.4 (patch 20230909). + This describes ncurses version 6.4 (patch 20230917).
AUTHOR
@@ -295,7 +295,7 @@ -ncurses 6.4 2023-08-19 panel(3x) +ncurses 6.4 2023-09-16 panel(3x)

diff --git a/doc/html/man/resizeterm.3x.html b/doc/html/man/resizeterm.3x.html index 638d5045..5c3979cd 100644 --- a/doc/html/man/resizeterm.3x.html +++ b/doc/html/man/resizeterm.3x.html @@ -28,19 +28,19 @@ * authorization. * **************************************************************************** * Author: Thomas E. Dickey 1996-on - * @Id: resizeterm.3x,v 1.36 2023/07/01 15:46:10 tom Exp @ + * @Id: resizeterm.3x,v 1.40 2023/09/16 23:38:39 tom Exp @ --> -resizeterm 3x 2023-07-01 ncurses 6.4 Library calls +resizeterm 3x 2023-09-16 ncurses 6.4 Library calls -
resizeterm 3x 2023-07-01 ncurses 6.4 Library calls
+
resizeterm 3x 2023-09-16 ncurses 6.4 Library calls

resizeterm(3x) Library calls resizeterm(3x) @@ -48,8 +48,8 @@
NAME
- is_term_resized, resize_term, resizeterm - change the curses terminal - size + is_term_resized, resize_term, resizeterm - manage the terminal + dimensions understood by curses
SYNOPSIS
@@ -192,7 +192,7 @@ -ncurses 6.4 2023-07-01 resizeterm(3x) +ncurses 6.4 2023-09-16 resizeterm(3x)

diff --git a/doc/html/man/scr_dump.5.html b/doc/html/man/scr_dump.5.html index f090e278..97181eeb 100644 --- a/doc/html/man/scr_dump.5.html +++ b/doc/html/man/scr_dump.5.html @@ -27,19 +27,19 @@ * sale, use or other dealings in this Software without prior written * * authorization. * **************************************************************************** - * @Id: scr_dump.5,v 1.27 2023/09/09 21:20:16 tom Exp @ + * @Id: scr_dump.5,v 1.31 2023/09/16 23:38:39 tom Exp @ --> -scr_dump 5 2023-09-09 ncurses 6.4 File formats +scr_dump 5 2023-09-16 ncurses 6.4 File formats -
scr_dump 5 2023-09-09 ncurses 6.4 File formats
+
scr_dump 5 2023-09-16 ncurses 6.4 File formats

scr_dump(5) File formats scr_dump(5) @@ -47,7 +47,7 @@
NAME
- scr_dump - format of curses screen-dumps. + scr_dump - curses screen dump
SYNOPSIS
@@ -407,7 +407,7 @@ -ncurses 6.4 2023-09-09 scr_dump(5) +ncurses 6.4 2023-09-16 scr_dump(5)

diff --git a/doc/html/man/tabs.1.html b/doc/html/man/tabs.1.html index cf8d9ab5..563da4db 100644 --- a/doc/html/man/tabs.1.html +++ b/doc/html/man/tabs.1.html @@ -27,19 +27,19 @@ * sale, use or other dealings in this Software without prior written * * authorization. * **************************************************************************** - * @Id: tabs.1,v 1.41 2023/09/09 21:19:07 tom Exp @ + * @Id: tabs.1,v 1.44 2023/09/16 23:38:39 tom Exp @ --> -tabs 1 2023-09-09 ncurses 6.4 User commands +tabs 1 2023-09-16 ncurses 6.4 User commands -
tabs 1 2023-09-09 ncurses 6.4 User commands
+
tabs 1 2023-09-16 ncurses 6.4 User commands

tabs(1) User commands tabs(1) @@ -47,7 +47,7 @@
NAME
- tabs - set tabs on a terminal + tabs - set terminal tab stops
SYNOPSIS
@@ -252,11 +252,11 @@
SEE ALSO
infocmp(1m), tset(1), curses(3x), terminfo(5). - This describes ncurses version 6.4 (patch 20230909). + This describes ncurses version 6.4 (patch 20230917). -ncurses 6.4 2023-09-09 tabs(1) +ncurses 6.4 2023-09-16 tabs(1)

diff --git a/doc/html/man/term.5.html b/doc/html/man/term.5.html index 356b849f..a87b1513 100644 --- a/doc/html/man/term.5.html +++ b/doc/html/man/term.5.html @@ -27,19 +27,19 @@ * sale, use or other dealings in this Software without prior written * * authorization. * **************************************************************************** - * @Id: term.5,v 1.52 2023/09/09 17:14:44 tom Exp @ + * @Id: term.5,v 1.56 2023/09/16 23:38:39 tom Exp @ --> -term 5 2023-09-09 ncurses 6.4 File formats +term 5 2023-09-16 ncurses 6.4 File formats -
term 5 2023-09-09 ncurses 6.4 File formats
+
term 5 2023-09-16 ncurses 6.4 File formats

term(5) File formats term(5) @@ -47,7 +47,7 @@
NAME
- term - format of compiled term file. + term - compiled terminfo terminal description
SYNOPSIS
@@ -378,7 +378,7 @@ -ncurses 6.4 2023-09-09 term(5) +ncurses 6.4 2023-09-16 term(5)

diff --git a/doc/html/man/term.7.html b/doc/html/man/term.7.html index 7e7980c5..3aae1fca 100644 --- a/doc/html/man/term.7.html +++ b/doc/html/man/term.7.html @@ -27,19 +27,20 @@ * sale, use or other dealings in this Software without prior written * * authorization. * **************************************************************************** - * @Id: term.7,v 1.35 2023/07/01 15:46:10 tom Exp @ + * @Id: term.7,v 1.36 2023/09/17 00:10:28 tom Exp @ + *SH SYNOPSIS --> -term 7 2023-07-01 ncurses 6.4 Miscellaneous +term 7 2023-09-16 ncurses 6.4 Miscellaneous -
term 7 2023-07-01 ncurses 6.4 Miscellaneous
+
term 7 2023-09-16 ncurses 6.4 Miscellaneous

term(7) Miscellaneous term(7) @@ -216,7 +217,7 @@ -ncurses 6.4 2023-07-01 term(7) +ncurses 6.4 2023-09-16 term(7)

diff --git a/doc/html/man/term_variables.3x.html b/doc/html/man/term_variables.3x.html index f5acf53b..0aeb5d8a 100644 --- a/doc/html/man/term_variables.3x.html +++ b/doc/html/man/term_variables.3x.html @@ -27,19 +27,19 @@ * sale, use or other dealings in this Software without prior written * * authorization. * **************************************************************************** - * @Id: term_variables.3x,v 1.23 2023/09/09 17:06:25 tom Exp @ + * @Id: term_variables.3x,v 1.27 2023/09/16 23:38:39 tom Exp @ --> -term_variables 3x 2023-09-09 ncurses 6.4 Library calls +term_variables 3x 2023-09-16 ncurses 6.4 Library calls -
term_variables 3x 2023-09-09 ncurses 6.4 Library calls
+
term_variables 3x 2023-09-16 ncurses 6.4 Library calls

term_variables(3x) Library calls term_variables(3x) @@ -47,9 +47,9 @@
NAME
- SP, acs_map, boolcodes, boolfnames, boolnames, cur_term, numcodes, - numfnames, numnames, strcodes, strfnames, strnames, ttytype - curses - terminfo global variables + SP, acs_map, boolcodes, boolfnames, boolnames, cur_term, numcodes, + numfnames, numnames, strcodes, strfnames, strnames, ttytype - terminfo + global variables
SYNOPSIS
@@ -83,9 +83,9 @@ curs_terminfo(3x) manual page. Depending on the configuration, these may be actual variables, or - macros (see curs_threads(3x)) which provide read-only access to curs- - es's state. In either case, applications should treat them as read-on- - ly to avoid confusing the library. + macros (see curs_threads(3x)) which provide read-only access to + curses's state. In either case, applications should treat them as + read-only to avoid confusing the library.
Alternate Character Set Mapping
@@ -97,43 +97,43 @@ Application developers need only know that it is used for the "ACS_" constants in <curses.h>. - The comparable data for the wide-character library is a private vari- - able. + The comparable data for the wide-character library is a private + variable.
Current Terminal Data
- After initializing the curses or terminfo interfaces, the cur_term con- - tains data describing the current terminal. This variable is also set - as a side-effect of set_term(3x) and delscreen(3x). + After initializing the curses or terminfo interfaces, the cur_term + contains data describing the current terminal. This variable is also + set as a side-effect of set_term(3x) and delscreen(3x). - It is possible to save a value of cur_term for subsequent use as a pa- - rameter to set_term, for switching between screens. Alternatively, one - can save the return value from newterm or setupterm(3x) to reuse in + It is possible to save a value of cur_term for subsequent use as a + parameter to set_term, for switching between screens. Alternatively, + one can save the return value from newterm or setupterm(3x) to reuse in set_term.
Terminfo Lookup Tables
The tic(1) and infocmp(1) programs use lookup tables for the long and short names of terminfo capabilities, as well as the corresponding - names for termcap capabilities. These are available to other applica- - tions, although the hash-tables used by the terminfo and termcap func- - tions are not available. + names for termcap capabilities. These are available to other + applications, although the hash-tables used by the terminfo and termcap + functions are not available. The long terminfo capability names use a "f" (eff) in their names: boolfnames, numfnames, and strfnames. - These are the short names for terminfo capabilities: boolnames, num- - names, and strnames. + These are the short names for terminfo capabilities: boolnames, + numnames, and strnames. - These are the corresponding names used for termcap descriptions: bool- - codes, numcodes, and strcodes. + These are the corresponding names used for termcap descriptions: + boolcodes, numcodes, and strcodes.
Terminal Type
A terminal description begins with one or more terminal names separated by "|" (vertical bars). On initialization of the curses or terminfo - interfaces, setupterm(3x) copies the terminal names to the array tty- - type. + interfaces, setupterm(3x) copies the terminal names to the array + ttytype.
Terminfo Names
@@ -143,8 +143,8 @@ #define CUR ((TERMTYPE *)(cur_term))-> - These symbols provide a faster method of accessing terminfo capabili- - ties than using tigetstr(3x), etc. + These symbols provide a faster method of accessing terminfo + capabilities than using tigetstr(3x), etc. The actual definition of CUR depends upon the implementation, but each terminfo library provides these long names defined to point into the @@ -176,7 +176,7 @@ -ncurses 6.4 2023-09-09 term_variables(3x) +ncurses 6.4 2023-09-16 term_variables(3x)

diff --git a/doc/html/man/terminfo.5.html b/doc/html/man/terminfo.5.html index 1d21b3f5..0578da6e 100644 --- a/doc/html/man/terminfo.5.html +++ b/doc/html/man/terminfo.5.html @@ -32,7 +32,7 @@ * sale, use or other dealings in this Software without prior written * * authorization. * **************************************************************************** - * @Id: terminfo.head,v 1.48 2023/09/09 21:34:18 tom Exp @ + * @Id: terminfo.head,v 1.51 2023/09/17 08:29:38 tom Exp @ * Head of terminfo man page ends here **************************************************************************** * Copyright 2018-2022,2023 Thomas E. Dickey * @@ -62,7 +62,7 @@ * sale, use or other dealings in this Software without prior written * * authorization. * **************************************************************************** - * @Id: terminfo.tail,v 1.130 2023/09/09 17:08:08 tom Exp @ + * @Id: terminfo.tail,v 1.131 2023/09/16 17:01:55 Branden.Robinson Exp @ *.in -2 *.in +2 *.in -2 @@ -73,12 +73,12 @@ -terminfo 5 2023-09-09 ncurses 6.4 File formats +terminfo 5 2023-09-17 ncurses 6.4 File formats -
terminfo 5 2023-09-09 ncurses 6.4 File formats
+
terminfo 5 2023-09-17 ncurses 6.4 File formats

terminfo(5) File formats terminfo(5) @@ -86,7 +86,7 @@
NAME
- terminfo - terminal capability database + terminfo - terminal capability database
SYNOPSIS
@@ -105,7 +105,7 @@ have, by specifying how to perform screen operations, and by specifying padding requirements and initialization sequences. - This manual describes ncurses version 6.4 (patch 20230909). + This manual describes ncurses version 6.4 (patch 20230917).
Terminfo Entry Syntax
@@ -2680,19 +2680,19 @@ /usr/share/terminfo/?/* files containing terminal descriptions +
AUTHORS
+ Zeyd M. Ben-Halim, Eric S. Raymond, Thomas E. Dickey. Based on pcurses + by Pavel Curtis. + +
SEE ALSO
infocmp(1m), tabs(1), tic(1m), curses(3x), curs_color(3x), curs_variables(3x), printf(3), term_variables(3x). term(5). user_caps(5). -
AUTHORS
- Zeyd M. Ben-Halim, Eric S. Raymond, Thomas E. Dickey. Based on pcurses - by Pavel Curtis. - - -ncurses 6.4 2023-09-09 terminfo(5) +ncurses 6.4 2023-09-17 terminfo(5)

@@ -2731,8 +2731,8 @@ ncurses 6.4 2023-09-09
EXTENSIONS

FILES
-
SEE ALSO

AUTHORS
+
SEE ALSO

diff --git a/doc/html/man/tic.1m.html b/doc/html/man/tic.1m.html index 433621cc..54ad85bb 100644 --- a/doc/html/man/tic.1m.html +++ b/doc/html/man/tic.1m.html @@ -27,19 +27,19 @@ * sale, use or other dealings in this Software without prior written * * authorization. * **************************************************************************** - * @Id: tic.1m,v 1.89 2023/09/02 22:29:35 tom Exp @ + * @Id: tic.1m,v 1.93 2023/09/16 23:38:39 tom Exp @ --> -tic 1m 2023-09-02 ncurses 6.4 User commands +tic 1m 2023-09-16 ncurses 6.4 User commands -
tic 1m 2023-09-02 ncurses 6.4 User commands
+
tic 1m 2023-09-16 ncurses 6.4 User commands

tic(1m) User commands tic(1m) @@ -47,7 +47,7 @@
NAME
- tic - the terminfo entry-description compiler + tic - compile terminal descriptions for terminfo or termcap
SYNOPSIS
@@ -475,7 +475,7 @@ captoinfo(1m), infocmp(1m), infotocap(1m), toe(1m), curses(3x), term(5). terminfo(5). user_caps(5). - This describes ncurses version 6.4 (patch 20230909). + This describes ncurses version 6.4 (patch 20230917).
AUTHOR
@@ -484,7 +484,7 @@ -ncurses 6.4 2023-09-02 tic(1m) +ncurses 6.4 2023-09-16 tic(1m)

diff --git a/doc/html/man/toe.1m.html b/doc/html/man/toe.1m.html index 272fecd2..6a334303 100644 --- a/doc/html/man/toe.1m.html +++ b/doc/html/man/toe.1m.html @@ -27,19 +27,19 @@ * sale, use or other dealings in this Software without prior written * * authorization. * **************************************************************************** - * @Id: toe.1m,v 1.42 2023/09/09 21:15:25 tom Exp @ + * @Id: toe.1m,v 1.46 2023/09/16 23:38:39 tom Exp @ --> -toe 1m 2023-09-09 ncurses 6.4 User commands +toe 1m 2023-09-16 ncurses 6.4 User commands -
toe 1m 2023-09-09 ncurses 6.4 User commands
+
toe 1m 2023-09-16 ncurses 6.4 User commands

toe(1m) User commands toe(1m) @@ -47,7 +47,7 @@
NAME
- toe - table of (terminfo) entries + toe - list table of entries of terminfo terminal types
SYNOPSIS
@@ -171,11 +171,11 @@ captoinfo(1m), infocmp(1m), infotocap(1m), tic(1m), curses(3x), terminfo(5). - This describes ncurses version 6.4 (patch 20230909). + This describes ncurses version 6.4 (patch 20230917). -ncurses 6.4 2023-09-09 toe(1m) +ncurses 6.4 2023-09-16 toe(1m)

diff --git a/doc/html/man/tput.1.html b/doc/html/man/tput.1.html index 2fcbfb04..42064ad5 100644 --- a/doc/html/man/tput.1.html +++ b/doc/html/man/tput.1.html @@ -28,19 +28,19 @@ * sale, use or other dealings in this Software without prior written * * authorization. * **************************************************************************** - * @Id: tput.1,v 1.79 2023/07/01 15:46:10 tom Exp @ + * @Id: tput.1,v 1.83 2023/09/16 23:38:39 tom Exp @ --> -tput 1 2023-07-01 ncurses 6.4 User commands +tput 1 2023-09-16 ncurses 6.4 User commands -
tput 1 2023-07-01 ncurses 6.4 User commands
+
tput 1 2023-09-16 ncurses 6.4 User commands

tput(1) User commands tput(1) @@ -48,7 +48,7 @@
NAME
- tput, reset - initialize a terminal or query terminfo database + tput, reset - initialize a terminal or query terminfo database
SYNOPSIS
@@ -545,11 +545,11 @@
SEE ALSO
clear(1), stty(1), tabs(1), tset(1), curs_termcap(3x), terminfo(5). - This describes ncurses version 6.4 (patch 20230909). + This describes ncurses version 6.4 (patch 20230917). -ncurses 6.4 2023-07-01 tput(1) +ncurses 6.4 2023-09-16 tput(1)

diff --git a/doc/html/man/tset.1.html b/doc/html/man/tset.1.html index 138286c7..4b07fc2d 100644 --- a/doc/html/man/tset.1.html +++ b/doc/html/man/tset.1.html @@ -27,19 +27,19 @@ * sale, use or other dealings in this Software without prior written * * authorization. * **************************************************************************** - * @Id: tset.1,v 1.66 2023/07/01 15:21:06 tom Exp @ + * @Id: tset.1,v 1.69 2023/09/16 23:38:39 tom Exp @ --> -tset 1 2023-07-01 ncurses 6.4 User commands +tset 1 2023-09-16 ncurses 6.4 User commands -
tset 1 2023-07-01 ncurses 6.4 User commands
+
tset 1 2023-09-16 ncurses 6.4 User commands

tset(1) User commands tset(1) @@ -47,7 +47,7 @@
NAME
- tset, reset - terminal initialization + tset, reset - initialize or reset terminal state
SYNOPSIS
@@ -392,11 +392,11 @@ csh(1), sh(1), stty(1), curs_terminfo(3x), tty(4), terminfo(5), ttys(5), environ(7) - This describes ncurses version 6.4 (patch 20230909). + This describes ncurses version 6.4 (patch 20230917). -ncurses 6.4 2023-07-01 tset(1) +ncurses 6.4 2023-09-16 tset(1)

diff --git a/doc/html/man/user_caps.5.html b/doc/html/man/user_caps.5.html index 1ef43321..061b203e 100644 --- a/doc/html/man/user_caps.5.html +++ b/doc/html/man/user_caps.5.html @@ -28,19 +28,19 @@ * sale, use or other dealings in this Software without prior written * * authorization. * **************************************************************************** - * @Id: user_caps.5,v 1.32 2023/09/09 21:25:30 tom Exp @ + * @Id: user_caps.5,v 1.36 2023/09/16 23:38:39 tom Exp @ --> -user_caps 5 2023-09-09 ncurses 6.4 File formats +user_caps 5 2023-09-16 ncurses 6.4 File formats -
user_caps 5 2023-09-09 ncurses 6.4 File formats
+
user_caps 5 2023-09-16 ncurses 6.4 File formats

user_caps(5) File formats user_caps(5) @@ -48,7 +48,7 @@
NAME
- user_caps - user-defined terminfo capabilities + user_caps - user-defined terminfo capability format
SYNOPSIS
@@ -394,7 +394,7 @@ -ncurses 6.4 2023-09-09 user_caps(5) +ncurses 6.4 2023-09-16 user_caps(5)

diff --git a/doc/html/man/wresize.3x.html b/doc/html/man/wresize.3x.html index de98a56d..5c332ce7 100644 --- a/doc/html/man/wresize.3x.html +++ b/doc/html/man/wresize.3x.html @@ -28,19 +28,19 @@ * authorization. * **************************************************************************** * Author: Thomas E. Dickey 1996 - * @Id: wresize.3x,v 1.24 2023/07/01 15:46:10 tom Exp @ + * @Id: wresize.3x,v 1.28 2023/09/16 23:38:39 tom Exp @ --> -wresize 3x 2023-07-01 ncurses 6.4 Library calls +wresize 3x 2023-09-16 ncurses 6.4 Library calls -
wresize 3x 2023-07-01 ncurses 6.4 Library calls
+
wresize 3x 2023-09-16 ncurses 6.4 Library calls

wresize(3x) Library calls wresize(3x) @@ -48,7 +48,7 @@
NAME
- wresize - resize a curses window + wresize - resize a curses window
SYNOPSIS
@@ -95,7 +95,7 @@ -ncurses 6.4 2023-07-01 wresize(3x) +ncurses 6.4 2023-09-16 wresize(3x)

diff --git a/man/MKada_config.in b/man/MKada_config.in index f1a956a7..ba30b57b 100644 --- a/man/MKada_config.in +++ b/man/MKada_config.in @@ -27,16 +27,17 @@ .\" authorization. * .\"*************************************************************************** .\" -.\" $Id: MKada_config.in,v 1.18 2023/09/09 23:32:29 tom Exp $ +.\" $Id: MKada_config.in,v 1.22 2023/09/17 08:29:17 tom Exp $ +.TH ADACURSES 1 2023-09-17 "ncurses @NCURSES_MAJOR@.@NCURSES_MINOR@" "User commands" .ds C adacurses@USE_CFG_SUFFIX@\-config -.TH ADACURSES 1 2023-09-09 "ncurses @NCURSES_MAJOR@.@NCURSES_MINOR@" "User commands" .ie n .ds CW R .el \{ .ie \n(.g .ds CW CR .el .ds CW CW .\} .SH NAME -adacurses@USE_CFG_SUFFIX@\-config \- helper script for @ADA_LIBNAME@ libraries +\fB\%adacurses@USE_CFG_SUFFIX@\-config\fP \- +helper script for @ADA_LIBNAME@ libraries .SH SYNOPSIS .B \*C [\fIoptions\fP] diff --git a/man/MKncu_config.in b/man/MKncu_config.in index 110bd8b1..a9372453 100644 --- a/man/MKncu_config.in +++ b/man/MKncu_config.in @@ -1,5 +1,5 @@ .\"*************************************************************************** -.\" Copyright 2020,2021 Thomas E. Dickey * +.\" Copyright 2020-2021,2023 Thomas E. Dickey * .\" Copyright 2010 Free Software Foundation, Inc. * .\" * .\" Permission is hereby granted, free of charge, to any person obtaining a * @@ -27,10 +27,11 @@ .\" authorization. * .\"*************************************************************************** .\" -.\" $Id: MKncu_config.in,v 1.7 2021/12/25 17:39:16 tom Exp $ -.TH @LIB_NAME@@DFT_ARG_SUFFIX@@cf_cv_abi_version@-config 1 2021-12-25 "ncurses @NCURSES_MAJOR@.@NCURSES_MINOR@" "User commands" +.\" $Id: MKncu_config.in,v 1.12 2023/09/17 08:29:56 tom Exp $ +.TH @LIB_NAME@@DFT_ARG_SUFFIX@@cf_cv_abi_version@-config 1 2023-09-17 "ncurses @NCURSES_MAJOR@.@NCURSES_MINOR@" "User commands" .SH NAME -@LIB_NAME@@DFT_ARG_SUFFIX@@cf_cv_abi_version@-config \- helper script for ncurses libraries +\fB\%@LIB_NAME@@DFT_ARG_SUFFIX@@cf_cv_abi_version@-config\fP \- +helper script for \fIncurses\fR libraries .SH SYNOPSIS .B @LIB_NAME@@DFT_ARG_SUFFIX@@cf_cv_abi_version@-config [\fIoptions\fP] diff --git a/man/captoinfo.1m b/man/captoinfo.1m index 55b43f32..65f191f0 100644 --- a/man/captoinfo.1m +++ b/man/captoinfo.1m @@ -28,14 +28,20 @@ .\" authorization. * .\"*************************************************************************** .\" -.\" $Id: captoinfo.1m,v 1.39 2023/09/09 16:40:25 tom Exp $ -.TH @CAPTOINFO@ 1M 2023-09-09 "ncurses 6.4" "User commands" +.\" $Id: captoinfo.1m,v 1.44 2023/09/16 23:39:05 tom Exp $ +.TH @CAPTOINFO@ 1M 2023-09-16 "ncurses 6.4" "User commands" .ds n 5 .ds d @TERMINFO@ .SH NAME -\fB@CAPTOINFO@\fP \- convert a \fItermcap\fP description into a \fIterminfo\fP description +\fB\%@CAPTOINFO@\fP \- +convert a \fItermcap\fR description into a \fIterminfo\fR description .SH SYNOPSIS -\fB@CAPTOINFO@\fR [\fB\-v\fIn\fR \fIwidth\fR] [\fB\-V\fR] [\fB\-1\fR] [\fB\-w\fR \fIwidth\fR] \fIfile\fR ... +.B @CAPTOINFO@ +.RI [ tic-option ] +.I file +\&.\|.\|. +.P +\fB@CAPTOINFO@\fR \fB\-V\fR .SH DESCRIPTION \fB@CAPTOINFO@\fP looks in each given text \fIfile\fP for \fBtermcap\fP descriptions. @@ -52,21 +58,18 @@ the terminal whose name is specified in the environment variable \fBTERM\fP is extracted from that file. If the environment variable \fBTERMCAP\fP is not set, then the file \fB\*d\fP is read. -.TP 5 -\fB\-v\fP -print out tracing information on standard error as the program runs. -.TP 5 -\fB\-V\fP -print out the version of the program in use on standard error and exit. -.TP 5 -\fB\-1\fP -cause the fields to print out one to a line. -Otherwise, the fields -will be printed several to a line to a maximum width of 60 -characters. -.TP 5 -\fB\-w\fP -change the output to \fIwidth\fP characters. +.PP +This utility is implemented as a link to \fB@TIC@\fP(1M), +with the latter's +.B \-I +option implied. +You can use other \fB@TIC@\fP options such as +.BR \-1 , +.BR \-f , +.BR \-v , +.BR \-w , +and +.BR \-x . .SH FILES .TP 20 \*d @@ -181,9 +184,6 @@ Hewlett-Packard's terminfo library supports two nonstandard terminfo capabilities \fBmeml\fP (memory lock) and \fBmemu\fP (memory unlock). These will be discarded with a warning message. .SH NOTES -This utility is actually a link to \fB@TIC@\fP(1M), running in \fI\-I\fP mode. -You can use other \fB@TIC@\fP options such as \fB\-f\fP and \fB\-x\fP. -.PP The verbose option is not identical to SVr4's. Under SVr4, instead of following the \fB\-v\fP with a trace level n, you repeat it n times. diff --git a/man/clear.1 b/man/clear.1 index 3498dc7d..7b620fe8 100644 --- a/man/clear.1 +++ b/man/clear.1 @@ -27,8 +27,8 @@ .\" authorization. * .\"*************************************************************************** .\" -.\" $Id: clear.1,v 1.35 2023/09/09 21:12:26 tom Exp $ -.TH @CLEAR@ 1 2023-09-09 "ncurses 6.4" "User commands" +.\" $Id: clear.1,v 1.38 2023/09/16 23:39:05 tom Exp $ +.TH @CLEAR@ 1 2023-09-16 "ncurses 6.4" "User commands" .ie n .ds CW R .el \{ .ie \n(.g .ds CW CR @@ -60,7 +60,8 @@ .. .ds n 5 .SH NAME -\fB@CLEAR@\fP \- clear the terminal screen +\fB\%@CLEAR@\fP \- +clear the terminal screen .SH SYNOPSIS \fB@CLEAR@\fR [\fB\-T\fItype\fR] [\fB\-V\fR] [\fB\-x\fR] .SH DESCRIPTION diff --git a/man/curs_add_wch.3x b/man/curs_add_wch.3x index 43e39244..69c2ed0b 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.39 2023/08/19 20:37:30 tom Exp $ -.TH curs_add_wch 3X 2023-08-19 "ncurses 6.4" "Library calls" +.\" $Id: curs_add_wch.3x,v 1.43 2023/09/16 23:34:43 tom Exp $ +.TH curs_add_wch 3X 2023-09-16 "ncurses 6.4" "Library calls" .ie \n(.g .ds `` \(lq .el .ds `` `` .ie \n(.g .ds '' \(rq @@ -39,12 +39,13 @@ .el .IP \(bu 2 .. .SH NAME -\fBadd_wch\fP, -\fBwadd_wch\fP, -\fBmvadd_wch\fP, -\fBmvwadd_wch\fP, -\fBecho_wchar\fP, -\fBwecho_wchar\fP \- add a complex character and rendition to a \fBcurses\fP window, then advance the cursor +\fB\%add_wch\fP, +\fB\%wadd_wch\fP, +\fB\%mvadd_wch\fP, +\fB\%mvwadd_wch\fP, +\fB\%echo_wchar\fP, +\fB\%wecho_wchar\fP \- +add a \fIcurses\fR complex character to a window and advance the cursor .SH SYNOPSIS \fB#include \fP .sp diff --git a/man/curs_add_wchstr.3x b/man/curs_add_wchstr.3x index fa58192e..ac24b36d 100644 --- a/man/curs_add_wchstr.3x +++ b/man/curs_add_wchstr.3x @@ -1,5 +1,5 @@ .\"*************************************************************************** -.\" Copyright 2019-2021,2022 Thomas E. Dickey * +.\" Copyright 2019-2022,2023 Thomas E. Dickey * .\" Copyright 2002-2012,2017 Free Software Foundation, Inc. * .\" * .\" Permission is hereby granted, free of charge, to any person obtaining a * @@ -27,8 +27,8 @@ .\" authorization. * .\"*************************************************************************** .\" -.\" $Id: curs_add_wchstr.3x,v 1.20 2022/02/12 20:07:29 tom Exp $ -.TH curs_add_wchstr 3X 2022-02-12 "ncurses 6.4" "Library calls" +.\" $Id: curs_add_wchstr.3x,v 1.25 2023/09/16 23:34:43 tom Exp $ +.TH curs_add_wchstr 3X 2023-09-16 "ncurses 6.4" "Library calls" .ie \n(.g .ds `` \(lq .el .ds `` `` .ie \n(.g .ds '' \(rq @@ -37,19 +37,16 @@ .ie n .IP \(bu 4 .el .IP \(bu 2 .. -.na -.hy 0 .SH NAME -\fBadd_wchstr\fP, -\fBadd_wchnstr\fP, -\fBwadd_wchstr\fP, -\fBwadd_wchnstr\fP, -\fBmvadd_wchstr\fP, -\fBmvadd_wchnstr\fP, -\fBmvwadd_wchstr\fP, -\fBmvwadd_wchnstr\fP \- add an array of complex characters (and attributes) to a curses window -.ad -.hy +\fB\%add_wchstr\fP, +\fB\%add_wchnstr\fP, +\fB\%wadd_wchstr\fP, +\fB\%wadd_wchnstr\fP, +\fB\%mvadd_wchstr\fP, +\fB\%mvadd_wchnstr\fP, +\fB\%mvwadd_wchstr\fP, +\fB\%mvwadd_wchnstr\fP \- +add a \fIcurses\fR complex character string to a window .SH SYNOPSIS .nf \fB#include \fP diff --git a/man/curs_addch.3x b/man/curs_addch.3x index 92e73786..7cfc3db9 100644 --- a/man/curs_addch.3x +++ b/man/curs_addch.3x @@ -28,8 +28,8 @@ .\" authorization. * .\"*************************************************************************** .\" -.\" $Id: curs_addch.3x,v 1.65 2023/08/19 19:45:54 tom Exp $ -.TH curs_addch 3X 2023-08-19 "ncurses 6.4" "Library calls" +.\" $Id: curs_addch.3x,v 1.69 2023/09/16 23:34:43 tom Exp $ +.TH curs_addch 3X 2023-09-16 "ncurses 6.4" "Library calls" .ie \n(.g .ds `` \(lq .el .ds `` `` .ie \n(.g .ds '' \(rq @@ -39,12 +39,13 @@ .el .IP \(bu 2 .. .SH NAME -\fBaddch\fP, -\fBwaddch\fP, -\fBmvaddch\fP, -\fBmvwaddch\fP, -\fBechochar\fP, -\fBwechochar\fP \- add a character (with attributes) to a \fBcurses\fP window, then advance the cursor +\fB\%addch\fP, +\fB\%waddch\fP, +\fB\%mvaddch\fP, +\fB\%mvwaddch\fP, +\fB\%echochar\fP, +\fB\%wechochar\fP \- +add a \fIcurses\fR character to a window and advance the cursor .SH SYNOPSIS \fB#include \fP .PP diff --git a/man/curs_addchstr.3x b/man/curs_addchstr.3x index 906b54a3..fbf46367 100644 --- a/man/curs_addchstr.3x +++ b/man/curs_addchstr.3x @@ -1,5 +1,5 @@ .\"*************************************************************************** -.\" Copyright 2019-2021,2022 Thomas E. Dickey * +.\" Copyright 2019-2022,2023 Thomas E. Dickey * .\" Copyright 1998-2012,2017 Free Software Foundation, Inc. * .\" * .\" Permission is hereby granted, free of charge, to any person obtaining a * @@ -27,8 +27,8 @@ .\" authorization. * .\"*************************************************************************** .\" -.\" $Id: curs_addchstr.3x,v 1.26 2022/02/12 20:07:29 tom Exp $ -.TH curs_addchstr 3X 2022-02-12 "ncurses 6.4" "Library calls" +.\" $Id: curs_addchstr.3x,v 1.31 2023/09/16 23:34:43 tom Exp $ +.TH curs_addchstr 3X 2023-09-16 "ncurses 6.4" "Library calls" .ie \n(.g .ds `` \(lq .el .ds `` `` .ie \n(.g .ds '' \(rq @@ -37,19 +37,16 @@ .ie n .IP \(bu 4 .el .IP \(bu 2 .. -.na -.hy 0 .SH NAME -\fBaddchstr\fP, -\fBaddchnstr\fP, -\fBwaddchstr\fP, -\fBwaddchnstr\fP, -\fBmvaddchstr\fP, -\fBmvaddchnstr\fP, -\fBmvwaddchstr\fP, -\fBmvwaddchnstr\fP \- add a string of characters (and attributes) to a \fBcurses\fP window -.ad -.hy +\fB\%addchstr\fP, +\fB\%addchnstr\fP, +\fB\%waddchstr\fP, +\fB\%waddchnstr\fP, +\fB\%mvaddchstr\fP, +\fB\%mvaddchnstr\fP, +\fB\%mvwaddchstr\fP, +\fB\%mvwaddchnstr\fP \- +add a \fIcurses\fR character string to a window .SH SYNOPSIS .nf \fB#include \fP diff --git a/man/curs_addstr.3x b/man/curs_addstr.3x index 3eac89b6..e7543bb9 100644 --- a/man/curs_addstr.3x +++ b/man/curs_addstr.3x @@ -27,8 +27,8 @@ .\" authorization. * .\"*************************************************************************** .\" -.\" $Id: curs_addstr.3x,v 1.28 2023/03/11 20:40:52 tom Exp $ -.TH curs_addstr 3X 2023-03-11 "ncurses 6.4" "Library calls" +.\" $Id: curs_addstr.3x,v 1.32 2023/09/16 23:34:43 tom Exp $ +.TH curs_addstr 3X 2023-09-16 "ncurses 6.4" "Library calls" .ie \n(.g .ds `` \(lq .el .ds `` `` .ie \n(.g .ds '' \(rq @@ -37,19 +37,16 @@ .ie n .IP \(bu 4 .el .IP \(bu 2 .. -.na -.hy 0 .SH NAME -\fBaddstr\fP, -\fBaddnstr\fP, -\fBwaddstr\fP, -\fBwaddnstr\fP, -\fBmvaddstr\fP, -\fBmvaddnstr\fP, -\fBmvwaddstr\fP, -\fBmvwaddnstr\fP \- add a string of characters to a \fBcurses\fP window and advance cursor -.ad -.hy +\fB\%addstr\fP, +\fB\%addnstr\fP, +\fB\%waddstr\fP, +\fB\%waddnstr\fP, +\fB\%mvaddstr\fP, +\fB\%mvaddnstr\fP, +\fB\%mvwaddstr\fP, +\fB\%mvwaddnstr\fP \- +add a string to a \fIcurses\fR window and advance the cursor .SH SYNOPSIS .nf \fB#include \fP diff --git a/man/curs_addwstr.3x b/man/curs_addwstr.3x index 072b29bc..a0a1b423 100644 --- a/man/curs_addwstr.3x +++ b/man/curs_addwstr.3x @@ -27,8 +27,8 @@ .\" authorization. * .\"*************************************************************************** .\" -.\" $Id: curs_addwstr.3x,v 1.20 2023/07/15 17:11:59 tom Exp $ -.TH curs_addwstr 3X 2023-07-15 "ncurses 6.4" "Library calls" +.\" $Id: curs_addwstr.3x,v 1.24 2023/09/16 23:34:43 tom Exp $ +.TH curs_addwstr 3X 2023-09-16 "ncurses 6.4" "Library calls" .ie \n(.g .ds `` \(lq .el .ds `` `` .ie \n(.g .ds '' \(rq @@ -37,19 +37,16 @@ .ie n .IP \(bu 4 .el .IP \(bu 2 .. -.na -.hy 0 .SH NAME -\fBaddwstr\fP, -\fBaddnwstr\fP, -\fBwaddwstr\fP, -\fBwaddnwstr\fP, -\fBmvaddwstr\fP, -\fBmvaddnwstr\fP, -\fBmvwaddwstr\fP, -\fBmvwaddnwstr\fP \- add a string of wide characters to a \fBcurses\fP window and advance cursor -.ad -.hy +\fB\%addwstr\fP, +\fB\%addnwstr\fP, +\fB\%waddwstr\fP, +\fB\%waddnwstr\fP, +\fB\%mvaddwstr\fP, +\fB\%mvaddnwstr\fP, +\fB\%mvwaddwstr\fP, +\fB\%mvwaddnwstr\fP \- +add a wide-character string to a \fIcurses\fR window and advance the cursor .SH SYNOPSIS .nf \fB#include \fP diff --git a/man/curs_attr.3x b/man/curs_attr.3x index 0795102e..133e751d 100644 --- a/man/curs_attr.3x +++ b/man/curs_attr.3x @@ -28,8 +28,8 @@ .\" authorization. * .\"*************************************************************************** .\" -.\" $Id: curs_attr.3x,v 1.80 2023/09/09 21:13:26 tom Exp $ -.TH curs_attr 3X 2023-09-09 "ncurses 6.4" "Library calls" +.\" $Id: curs_attr.3x,v 1.84 2023/09/16 23:34:43 tom Exp $ +.TH curs_attr 3X 2023-09-16 "ncurses 6.4" "Library calls" .ie \n(.g .ds `` \(lq .el .ds `` `` .ie \n(.g .ds '' \(rq @@ -57,42 +57,33 @@ .ie n .IP \(bu 4 .el .IP \(bu 2 .. -.na -.hy 0 .\" --------------------------------------------------------------------------- .SH NAME -.\" attr_get -\fBattr_get\fP, -\fBwattr_get\fP, -\fBattr_set\fP, -\fBwattr_set\fP, -.\" .br -\fBattr_off\fP, -\fBwattr_off\fP, -\fBattr_on\fP, -\fBwattr_on\fP, -.\" .br -\fBattroff\fP, -\fBwattroff\fP, -\fBattron\fP, -\fBwattron\fP, -\fBattrset\fP, -\fBwattrset\fP, -.\" .br -\fBchgat\fP, -\fBwchgat\fP, -\fBmvchgat\fP, -\fBmvwchgat\fP, -.\" .br -\fBcolor_set\fP, -\fBwcolor_set\fP, -.\" .br -\fBstandend\fP, -\fBwstandend\fP, -\fBstandout\fP, -\fBwstandout\fP \- \fBcurses\fP character and window attribute control routines -.ad -.hy +\fB\%attr_get\fP, +\fB\%wattr_get\fP, +\fB\%attr_set\fP, +\fB\%wattr_set\fP, +\fB\%attr_off\fP, +\fB\%wattr_off\fP, +\fB\%attr_on\fP, +\fB\%wattr_on\fP, +\fB\%attroff\fP, +\fB\%wattroff\fP, +\fB\%attron\fP, +\fB\%wattron\fP, +\fB\%attrset\fP, +\fB\%wattrset\fP, +\fB\%chgat\fP, +\fB\%wchgat\fP, +\fB\%mvchgat\fP, +\fB\%mvwchgat\fP, +\fB\%color_set\fP, +\fB\%wcolor_set\fP, +\fB\%standend\fP, +\fB\%wstandend\fP, +\fB\%standout\fP, +\fB\%wstandout\fP \- +manipulate attributes of character cells in \fIcurses\fR windows .\" --------------------------------------------------------------------------- .SH SYNOPSIS \fB#include \fP diff --git a/man/curs_beep.3x b/man/curs_beep.3x index be18f910..2f0a8291 100644 --- a/man/curs_beep.3x +++ b/man/curs_beep.3x @@ -1,5 +1,5 @@ .\"*************************************************************************** -.\" Copyright 2018-2020,2021 Thomas E. Dickey * +.\" Copyright 2018-2021,2023 Thomas E. Dickey * .\" Copyright 1998-2005,2010 Free Software Foundation, Inc. * .\" * .\" Permission is hereby granted, free of charge, to any person obtaining a * @@ -27,10 +27,12 @@ .\" authorization. * .\"*************************************************************************** .\" -.\" $Id: curs_beep.3x,v 1.17 2021/12/25 21:41:58 tom Exp $ -.TH curs_beep 3X 2021-12-25 "ncurses 6.4" "Library calls" +.\" $Id: curs_beep.3x,v 1.22 2023/09/16 23:34:43 tom Exp $ +.TH curs_beep 3X 2023-09-16 "ncurses 6.4" "Library calls" .SH NAME -\fBbeep\fP, \fBflash\fP \- \fBcurses\fP bell and screen flash routines +\fB\%beep\fP, +\fB\%flash\fP \- +ring the (visual) bell of the terminal with \fIcurses\fR .SH SYNOPSIS \fB#include \fP .PP diff --git a/man/curs_bkgd.3x b/man/curs_bkgd.3x index 927b009e..b95ee2ab 100644 --- a/man/curs_bkgd.3x +++ b/man/curs_bkgd.3x @@ -27,16 +27,19 @@ .\" authorization. * .\"*************************************************************************** .\" -.\" $Id: curs_bkgd.3x,v 1.39 2023/07/01 15:43:20 tom Exp $ +.\" $Id: curs_bkgd.3x,v 1.44 2023/09/16 23:34:43 tom Exp $ +.TH curs_bkgd 3X 2023-09-16 "ncurses 6.4" "Library calls" .de bP .ie n .IP \(bu 4 .el .IP \(bu 2 .. -.TH curs_bkgd 3X 2023-07-01 "ncurses 6.4" "Library calls" .SH NAME -\fBbkgdset\fP, \fBwbkgdset\fP, -\fBbkgd\fP, \fBwbkgd\fP, -\fBgetbkgd\fP \- \fBcurses\fP window background manipulation routines +\fB\%bkgdset\fP, +\fB\%wbkgdset\fP, +\fB\%bkgd\fP, +\fB\%wbkgd\fP, +\fB\%getbkgd\fP \- +manipulate background of a \fIcurses\fR window of characters .SH SYNOPSIS \fB#include \fP .PP diff --git a/man/curs_bkgrnd.3x b/man/curs_bkgrnd.3x index 95f9b83b..7a789453 100644 --- a/man/curs_bkgrnd.3x +++ b/man/curs_bkgrnd.3x @@ -27,25 +27,26 @@ .\" authorization. * .\"*************************************************************************** .\" -.\" $Id: curs_bkgrnd.3x,v 1.21 2023/08/12 18:31:54 tom Exp $ +.\" $Id: curs_bkgrnd.3x,v 1.27 2023/09/16 23:34:43 tom Exp $ +.TH curs_bkgrnd 3X 2023-09-16 "ncurses 6.4" "Library calls" .de bP .ie n .IP \(bu 4 .el .IP \(bu 2 .. -.TH curs_bkgrnd 3X 2023-08-12 "ncurses 6.4" "Library calls" .SH NAME -\fBbkgrnd\fP, -\fBwbkgrnd\fP, -\fBbkgrndset\fP, -\fBwbkgrndset\fP, -\fBgetbkgrnd\fP, -\fBwgetbkgrnd\fP \- \fBcurses\fP window complex background manipulation routines +\fB\%bkgrnd\fP, +\fB\%wbkgrnd\fP, +\fB\%bkgrndset\fP, +\fB\%wbkgrndset\fP, +\fB\%getbkgrnd\fP, +\fB\%wgetbkgrnd\fP \- +manipulate background of a \fIcurses\fP window of wide characters .SH SYNOPSIS \fB#include \fR .sp -\fBint bkgrnd(\fB const cchar_t *\fIwch\fB);\fR +\fBint bkgrnd(\fBconst cchar_t *\fIwch\fB);\fR .br -\fBint wbkgrnd(\fB WINDOW *\fIwin\fB, const cchar_t *\fIwch\fB);\fR +\fBint wbkgrnd(\fBWINDOW *\fIwin\fB, const cchar_t *\fIwch\fB);\fR .sp \fBvoid bkgrndset(const cchar_t *\fIwch\fR \fB);\fR .br @@ -87,9 +88,11 @@ Wherever the former background character appears, it is changed to the new background character. .SS getbkgrnd The \fBgetbkgrnd\fP function returns the given window's current background -character/attribute pair via the \fBwch\fP pointer. +character/attribute pair via the +.I wch +pointer. If the given window pointer is null, -the character is not updated (but no error returned). +the character is not updated (but no error is returned). .SH NOTES Note that \fBbkgrnd\fP, diff --git a/man/curs_border.3x b/man/curs_border.3x index a8fc0811..a3f75211 100644 --- a/man/curs_border.3x +++ b/man/curs_border.3x @@ -27,28 +27,25 @@ .\" authorization. * .\"*************************************************************************** .\" -.\" $Id: curs_border.3x,v 1.34 2023/07/01 15:43:20 tom Exp $ -.TH curs_border 3X 2023-07-01 "ncurses 6.4" "Library calls" +.\" $Id: curs_border.3x,v 1.38 2023/09/16 23:34:43 tom Exp $ +.TH curs_border 3X 2023-09-16 "ncurses 6.4" "Library calls" .ie \n(.g .ds `` \(lq .el .ds `` `` .ie \n(.g .ds '' \(rq .el .ds '' '' -.na -.hy 0 .SH NAME -\fBborder\fP, -\fBwborder\fP, -\fBbox\fP, -\fBhline\fP, -\fBwhline\fP, -\fBvline\fP, -\fBwvline\fP, -\fBmvhline\fP, -\fBmvwhline\fP, -\fBmvvline\fP, -\fBmvwvline\fP \- create \fBcurses\fP borders, horizontal and vertical lines -.ad -.hy +\fB\%border\fP, +\fB\%wborder\fP, +\fB\%box\fP, +\fB\%hline\fP, +\fB\%whline\fP, +\fB\%vline\fP, +\fB\%wvline\fP, +\fB\%mvhline\fP, +\fB\%mvwhline\fP, +\fB\%mvvline\fP, +\fB\%mvwvline\fP \- +draw borders and lines in a \fIcurses\fR window of characters .SH SYNOPSIS \fB#include \fP .sp diff --git a/man/curs_border_set.3x b/man/curs_border_set.3x index b8055d50..5b672f7d 100644 --- a/man/curs_border_set.3x +++ b/man/curs_border_set.3x @@ -27,28 +27,25 @@ .\" authorization. * .\"*************************************************************************** .\" -.\" $Id: curs_border_set.3x,v 1.20 2023/07/01 15:43:20 tom Exp $ -.TH curs_border_set 3X 2023-07-01 "ncurses 6.4" "Library calls" +.\" $Id: curs_border_set.3x,v 1.24 2023/09/16 23:34:43 tom Exp $ +.TH curs_border_set 3X 2023-09-16 "ncurses 6.4" "Library calls" .ie \n(.g .ds `` \(lq .el .ds `` `` .ie \n(.g .ds '' \(rq .el .ds '' '' -.na -.hy 0 .SH NAME -\fBborder_set\fP, -\fBwborder_set\fP, -\fBbox_set\fP, -\fBhline_set\fP, -\fBwhline_set\fP, -\fBmvhline_set\fP, -\fBmvwhline_set\fP, -\fBvline_set\fP, -\fBwvline_set\fP, -\fBmvvline_set\fP, -\fBmvwvline_set\fP \- create \fBcurses\fP borders or lines using complex characters and renditions -.ad -.hy +\fB\%border_set\fP, +\fB\%wborder_set\fP, +\fB\%box_set\fP, +\fB\%hline_set\fP, +\fB\%whline_set\fP, +\fB\%mvhline_set\fP, +\fB\%mvwhline_set\fP, +\fB\%vline_set\fP, +\fB\%wvline_set\fP, +\fB\%mvvline_set\fP, +\fB\%mvwvline_set\fP \- +draw borders and lines in a \fIcurses\fR window of wide characters .SH SYNOPSIS \fB#include \fP .sp diff --git a/man/curs_clear.3x b/man/curs_clear.3x index 71600b28..1c8d3535 100644 --- a/man/curs_clear.3x +++ b/man/curs_clear.3x @@ -27,25 +27,22 @@ .\" authorization. * .\"*************************************************************************** .\" -.\" $Id: curs_clear.3x,v 1.31 2023/07/01 15:43:20 tom Exp $ -.TH curs_clear 3X 2023-07-01 "ncurses 6.4" "Library calls" -.na -.hy 0 +.\" $Id: curs_clear.3x,v 1.35 2023/09/16 23:34:43 tom Exp $ +.TH curs_clear 3X 2023-09-16 "ncurses 6.4" "Library calls" .de bP .ie n .IP \(bu 4 .el .IP \(bu 2 .. .SH NAME -\fBerase\fP, -\fBwerase\fP, -\fBclear\fP, -\fBwclear\fP, -\fBclrtobot\fP, -\fBwclrtobot\fP, -\fBclrtoeol\fP, -\fBwclrtoeol\fP \- clear all or part of a \fBcurses\fP window -.ad -.hy +\fB\%erase\fP, +\fB\%werase\fP, +\fB\%clear\fP, +\fB\%wclear\fP, +\fB\%clrtobot\fP, +\fB\%wclrtobot\fP, +\fB\%clrtoeol\fP, +\fB\%wclrtoeol\fP \- +clear all or part of a \fIcurses\fR window .SH SYNOPSIS \fB#include \fP .sp diff --git a/man/curs_color.3x b/man/curs_color.3x index ffd55234..744ad385 100644 --- a/man/curs_color.3x +++ b/man/curs_color.3x @@ -27,8 +27,8 @@ .\" authorization. * .\"*************************************************************************** .\" -.\" $Id: curs_color.3x,v 1.73 2023/07/01 14:23:04 tom Exp $ -.TH curs_color 3X 2023-07-01 "ncurses 6.4" "Library calls" +.\" $Id: curs_color.3x,v 1.77 2023/09/16 23:34:43 tom Exp $ +.TH curs_color 3X 2023-09-16 "ncurses 6.4" "Library calls" .ie \n(.g .ds `` \(lq .el .ds `` `` .ie \n(.g .ds '' \(rq @@ -38,25 +38,22 @@ .el .IP \(bu 2 .. .ds n 5 -.na -.hy 0 .SH NAME -\fBstart_color\fP, -\fBhas_colors\fP, -\fBcan_change_color\fP, -\fBinit_pair\fP, -\fBinit_color\fP, -\fBinit_extended_pair\fP, -\fBinit_extended_color\fP, -\fBcolor_content\fP, -\fBpair_content\fP, -\fBextended_color_content\fP, -\fBextended_pair_content\fP, -\fBreset_color_pairs\fP, -\fBCOLOR_PAIR\fP, -\fBPAIR_NUMBER\fP \- \fBcurses\fP color manipulation routines -.ad -.hy +\fB\%start_color\fP, +\fB\%has_colors\fP, +\fB\%can_change_color\fP, +\fB\%init_pair\fP, +\fB\%init_color\fP, +\fB\%init_extended_pair\fP, +\fB\%init_extended_color\fP, +\fB\%color_content\fP, +\fB\%pair_content\fP, +\fB\%extended_color_content\fP, +\fB\%extended_pair_content\fP, +\fB\%reset_color_pairs\fP, +\fB\%COLOR_PAIR\fP, +\fB\%PAIR_NUMBER\fP \- +manipulate terminal colors with \fIcurses\fR .SH SYNOPSIS \fB#include \fP .sp diff --git a/man/curs_delch.3x b/man/curs_delch.3x index 161647a5..dab1d423 100644 --- a/man/curs_delch.3x +++ b/man/curs_delch.3x @@ -27,17 +27,18 @@ .\" authorization. * .\"*************************************************************************** .\" -.\" $Id: curs_delch.3x,v 1.22 2023/07/01 15:43:20 tom Exp $ -.TH curs_delch 3X 2023-07-01 "ncurses 6.4" "Library calls" +.\" $Id: curs_delch.3x,v 1.26 2023/09/16 23:34:43 tom Exp $ +.TH curs_delch 3X 2023-09-16 "ncurses 6.4" "Library calls" .ie \n(.g .ds `` \(lq .el .ds `` `` .ie \n(.g .ds '' \(rq .el .ds '' '' .SH NAME -\fBdelch\fP, -\fBwdelch\fP, -\fBmvdelch\fP, -\fBmvwdelch\fP \- delete character under the cursor in a \fBcurses\fP window +\fB\%delch\fP, +\fB\%wdelch\fP, +\fB\%mvdelch\fP, +\fB\%mvwdelch\fP \- +delete the character at the cursor in a \fIcurses\fR window .SH SYNOPSIS \fB#include \fP .sp diff --git a/man/curs_deleteln.3x b/man/curs_deleteln.3x index f8c6b449..55ef06a3 100644 --- a/man/curs_deleteln.3x +++ b/man/curs_deleteln.3x @@ -27,15 +27,16 @@ .\" authorization. * .\"*************************************************************************** .\" -.\" $Id: curs_deleteln.3x,v 1.24 2023/07/01 15:43:20 tom Exp $ -.TH curs_deleteln 3X 2023-07-01 "ncurses 6.4" "Library calls" +.\" $Id: curs_deleteln.3x,v 1.28 2023/09/16 23:34:43 tom Exp $ +.TH curs_deleteln 3X 2023-09-16 "ncurses 6.4" "Library calls" .SH NAME -\fBdeleteln\fP, -\fBwdeleteln\fP, -\fBinsdelln\fP, -\fBwinsdelln\fP, -\fBinsertln\fP, -\fBwinsertln\fP \- delete and insert lines in a \fBcurses\fP window +\fB\%deleteln\fP, +\fB\%wdeleteln\fP, +\fB\%insdelln\fP, +\fB\%winsdelln\fP, +\fB\%insertln\fP, +\fB\%winsertln\fP \- +delete or insert lines in a \fIcurses\fR window .SH SYNOPSIS \fB#include \fP .sp diff --git a/man/curs_extend.3x b/man/curs_extend.3x index 3764c23e..5ea88a02 100644 --- a/man/curs_extend.3x +++ b/man/curs_extend.3x @@ -29,16 +29,16 @@ .\" .\" Author: Thomas E. Dickey 1999-on .\" -.\" $Id: curs_extend.3x,v 1.32 2023/07/01 15:43:20 tom Exp $ -.TH curs_extend 3X 2023-07-01 "ncurses 6.4" "Library calls" +.\" $Id: curs_extend.3x,v 1.36 2023/09/16 23:34:43 tom Exp $ +.TH curs_extend 3X 2023-09-16 "ncurses 6.4" "Library calls" .ie \n(.g .ds `` \(lq .el .ds `` `` .ie \n(.g .ds '' \(rq .el .ds '' '' .SH NAME -\fBcurses_version\fP, -\fBuse_extended_names\fP \- miscellaneous curses extensions -. +\fB\%curses_version\fP, +\fB\%use_extended_names\fP \- +miscellaneous \fIcurses\fR extensions .SH SYNOPSIS \fB#include \fP .sp diff --git a/man/curs_get_wch.3x b/man/curs_get_wch.3x index be13c902..0a033174 100644 --- a/man/curs_get_wch.3x +++ b/man/curs_get_wch.3x @@ -1,5 +1,5 @@ .\"*************************************************************************** -.\" Copyright 2018-2021,2022 Thomas E. Dickey * +.\" Copyright 2018-2022,2023 Thomas E. Dickey * .\" Copyright 2002-2016,2017 Free Software Foundation, Inc. * .\" * .\" Permission is hereby granted, free of charge, to any person obtaining a * @@ -27,10 +27,8 @@ .\" authorization. * .\"*************************************************************************** .\" -.\" $Id: curs_get_wch.3x,v 1.18 2022/02/12 20:07:29 tom Exp $ -.TH curs_get_wch 3X 2022-02-12 "ncurses 6.4" "Library calls" -.na -.hy 0 +.\" $Id: curs_get_wch.3x,v 1.23 2023/09/16 23:34:43 tom Exp $ +.TH curs_get_wch 3X 2023-09-16 "ncurses 6.4" "Library calls" .ie \n(.g .ds `` \(lq .el .ds `` `` .ie \n(.g .ds '' \(rq @@ -40,13 +38,12 @@ .el .IP \(bu 2 .. .SH NAME -\fBget_wch\fP, -\fBwget_wch\fP, -\fBmvget_wch\fP, -\fBmvwget_wch\fP, -\fBunget_wch\fP \- get (or push back) a wide character from curses terminal keyboard -.ad -.hy +\fB\%get_wch\fP, +\fB\%wget_wch\fP, +\fB\%mvget_wch\fP, +\fB\%mvwget_wch\fP, +\fB\%unget_wch\fP \- +get (or push back) a wide character from \fIcurses\fR terminal keyboard .SH SYNOPSIS \fB#include \fP .sp diff --git a/man/curs_get_wstr.3x b/man/curs_get_wstr.3x index 2d632522..ec2bac77 100644 --- a/man/curs_get_wstr.3x +++ b/man/curs_get_wstr.3x @@ -27,8 +27,8 @@ .\" authorization. * .\"*************************************************************************** .\" -.\" $Id: curs_get_wstr.3x,v 1.30 2023/08/05 12:14:30 tom Exp $ -.TH curs_get_wstr 3X 2023-08-05 "ncurses 6.4" "Library calls" +.\" $Id: curs_get_wstr.3x,v 1.34 2023/09/16 23:34:43 tom Exp $ +.TH curs_get_wstr 3X 2023-09-16 "ncurses 6.4" "Library calls" .ie \n(.g .ds `` \(lq .el .ds `` `` .ie \n(.g .ds '' \(rq @@ -37,19 +37,16 @@ .ie n .IP \(bu 4 .el .IP \(bu 2 .. -.na -.hy 0 .SH NAME -\fBget_wstr\fP, -\fBgetn_wstr\fP, -\fBwget_wstr\fP, -\fBwgetn_wstr\fP, -\fBmvget_wstr\fP, -\fBmvgetn_wstr\fP, -\fBmvwget_wstr\fP, -\fBmvwgetn_wstr\fP \- get an array of wide characters from a curses terminal keyboard -.ad -.hy +\fB\%get_wstr\fP, +\fB\%getn_wstr\fP, +\fB\%wget_wstr\fP, +\fB\%wgetn_wstr\fP, +\fB\%mvget_wstr\fP, +\fB\%mvgetn_wstr\fP, +\fB\%mvwget_wstr\fP, +\fB\%mvwgetn_wstr\fP \- +get a wide-character string from a \fIcurses\fR terminal keyboard .SH SYNOPSIS .nf \fB#include \fP diff --git a/man/curs_getcchar.3x b/man/curs_getcchar.3x index 1ebcdb57..3e6971ab 100644 --- a/man/curs_getcchar.3x +++ b/man/curs_getcchar.3x @@ -27,15 +27,16 @@ .\" authorization. * .\"*************************************************************************** .\" -.\" $Id: curs_getcchar.3x,v 1.31 2023/07/01 15:43:20 tom Exp $ -.TH curs_getcchar 3X 2023-07-01 "ncurses 6.4" "Library calls" +.\" $Id: curs_getcchar.3x,v 1.35 2023/09/16 23:34:43 tom Exp $ +.TH curs_getcchar 3X 2023-09-16 "ncurses 6.4" "Library calls" .de bP .ie n .IP \(bu 4 .el .IP \(bu 2 .. .SH NAME -\fBgetcchar\fP, -\fBsetcchar\fP \- Get a wide character string and rendition from a \fBcchar_t\fP or set a \fBcchar_t\fP from a wide-character string +\fB\%getcchar\fP, +\fB\%setcchar\fP \- +convert between a wide-character string and a \fIcurses\fR complex character string .SH SYNOPSIS \fB#include \fP .sp diff --git a/man/curs_getch.3x b/man/curs_getch.3x index 9f84f8c3..b0952027 100644 --- a/man/curs_getch.3x +++ b/man/curs_getch.3x @@ -28,10 +28,8 @@ .\" authorization. * .\"*************************************************************************** .\" -.\" $Id: curs_getch.3x,v 1.68 2023/08/19 20:45:12 tom Exp $ -.TH curs_getch 3X 2023-08-19 "ncurses 6.4" "Library calls" -.na -.hy 0 +.\" $Id: curs_getch.3x,v 1.72 2023/09/16 23:34:43 tom Exp $ +.TH curs_getch 3X 2023-09-16 "ncurses 6.4" "Library calls" .ie \n(.g .ds `` \(lq .el .ds `` `` .ie \n(.g .ds '' \(rq @@ -41,14 +39,13 @@ .el .IP \(bu 2 .. .SH NAME -\fBgetch\fP, -\fBwgetch\fP, -\fBmvgetch\fP, -\fBmvwgetch\fP, -\fBungetch\fP, -\fBhas_key\fP \- get (or push back) characters from \fBcurses\fP terminal keyboard -.ad -.hy +\fB\%getch\fP, +\fB\%wgetch\fP, +\fB\%mvgetch\fP, +\fB\%mvwgetch\fP, +\fB\%ungetch\fP, +\fB\%has_key\fP \- +get (or push back) characters from \fIcurses\fR terminal keyboard .SH SYNOPSIS .B #include .PP diff --git a/man/curs_getstr.3x b/man/curs_getstr.3x index b6648033..ba385e2b 100644 --- a/man/curs_getstr.3x +++ b/man/curs_getstr.3x @@ -27,8 +27,8 @@ .\" authorization. * .\"*************************************************************************** .\" -.\" $Id: curs_getstr.3x,v 1.42 2023/08/05 12:14:30 tom Exp $ -.TH curs_getstr 3X 2023-08-05 "ncurses 6.4" "Library calls" +.\" $Id: curs_getstr.3x,v 1.46 2023/09/16 23:34:43 tom Exp $ +.TH curs_getstr 3X 2023-09-16 "ncurses 6.4" "Library calls" .ie \n(.g .ds `` \(lq .el .ds `` `` .ie \n(.g .ds '' \(rq @@ -37,19 +37,16 @@ .ie n .IP \(bu 4 .el .IP \(bu 2 .. -.na -.hy 0 .SH NAME -\fBgetstr\fP, -\fBgetnstr\fP, -\fBwgetstr\fP, -\fBwgetnstr\fP, -\fBmvgetstr\fP, -\fBmvgetnstr\fP, -\fBmvwgetstr\fP, -\fBmvwgetnstr\fP \- accept character strings from \fBcurses\fP terminal keyboard -.ad -.hy +\fB\%getstr\fP, +\fB\%getnstr\fP, +\fB\%wgetstr\fP, +\fB\%wgetnstr\fP, +\fB\%mvgetstr\fP, +\fB\%mvgetnstr\fP, +\fB\%mvwgetstr\fP, +\fB\%mvwgetnstr\fP \- +accept character strings from \fIcurses\fR terminal keyboard .SH SYNOPSIS \fB#include \fP .sp diff --git a/man/curs_getyx.3x b/man/curs_getyx.3x index ff49c86f..05bce4f9 100644 --- a/man/curs_getyx.3x +++ b/man/curs_getyx.3x @@ -27,13 +27,14 @@ .\" authorization. * .\"*************************************************************************** .\" -.\" $Id: curs_getyx.3x,v 1.27 2023/07/01 15:43:20 tom Exp $ -.TH curs_getyx 3X 2023-07-01 "ncurses 6.4" "Library calls" +.\" $Id: curs_getyx.3x,v 1.31 2023/09/16 23:37:03 tom Exp $ +.TH curs_getyx 3X 2023-09-16 "ncurses 6.4" "Library calls" .SH NAME -\fBgetyx\fP, -\fBgetparyx\fP, -\fBgetbegyx\fP, -\fBgetmaxyx\fP \- get \fBcurses\fP cursor and window coordinates +\fB\%getyx\fP, +\fB\%getparyx\fP, +\fB\%getbegyx\fP, +\fB\%getmaxyx\fP \- +get \fIcurses\fR cursor and window coordinates .SH SYNOPSIS \fB#include \fP .sp diff --git a/man/curs_in_wch.3x b/man/curs_in_wch.3x index bd009dfc..feaf2bc8 100644 --- a/man/curs_in_wch.3x +++ b/man/curs_in_wch.3x @@ -1,5 +1,5 @@ .\"*************************************************************************** -.\" Copyright 2018-2021,2022 Thomas E. Dickey * +.\" Copyright 2018-2022,2023 Thomas E. Dickey * .\" Copyright 2002-2010,2017 Free Software Foundation, Inc. * .\" * .\" Permission is hereby granted, free of charge, to any person obtaining a * @@ -27,17 +27,18 @@ .\" authorization. * .\"*************************************************************************** .\" -.\" $Id: curs_in_wch.3x,v 1.14 2022/02/12 20:07:29 tom Exp $ -.TH curs_in_wch 3X 2022-02-12 "ncurses 6.4" "Library calls" +.\" $Id: curs_in_wch.3x,v 1.19 2023/09/16 23:37:03 tom Exp $ +.TH curs_in_wch 3X 2023-09-16 "ncurses 6.4" "Library calls" .ie \n(.g .ds `` \(lq .el .ds `` `` .ie \n(.g .ds '' \(rq .el .ds '' '' .SH NAME -\fBin_wch\fP, -\fBmvin_wch\fP, -\fBmvwin_wch\fP, -\fBwin_wch\fP \- extract a complex character and rendition from a window +\fB\%in_wch\fP, +\fB\%mvin_wch\fP, +\fB\%mvwin_wch\fP, +\fB\%win_wch\fP \- +get a \fIcurses\fR complex character from a window .SH SYNOPSIS \fB#include \fP .sp diff --git a/man/curs_in_wchstr.3x b/man/curs_in_wchstr.3x index 551f52c2..3888f885 100644 --- a/man/curs_in_wchstr.3x +++ b/man/curs_in_wchstr.3x @@ -1,5 +1,5 @@ .\"*************************************************************************** -.\" Copyright 2018-2021,2022 Thomas E. Dickey * +.\" Copyright 2018-2022,2023 Thomas E. Dickey * .\" Copyright 2002-2012,2017 Free Software Foundation, Inc. * .\" * .\" Permission is hereby granted, free of charge, to any person obtaining a * @@ -27,25 +27,22 @@ .\" authorization. * .\"*************************************************************************** .\" -.\" $Id: curs_in_wchstr.3x,v 1.18 2022/02/12 20:07:29 tom Exp $ -.TH curs_in_wchstr 3X 2022-02-12 "ncurses 6.4" "Library calls" +.\" $Id: curs_in_wchstr.3x,v 1.23 2023/09/16 23:37:03 tom Exp $ +.TH curs_in_wchstr 3X 2023-09-16 "ncurses 6.4" "Library calls" .ie \n(.g .ds `` \(lq .el .ds `` `` .ie \n(.g .ds '' \(rq .el .ds '' '' -.na -.hy 0 .SH NAME -\fBin_wchstr\fP, -\fBin_wchnstr\fP, -\fBwin_wchstr\fP, -\fBwin_wchnstr\fP, -\fBmvin_wchstr\fP, -\fBmvin_wchnstr\fP, -\fBmvwin_wchstr\fP, -\fBmvwin_wchnstr\fP \- get an array of complex characters and renditions from a curses window -.ad -.hy +\fB\%in_wchstr\fP, +\fB\%in_wchnstr\fP, +\fB\%win_wchstr\fP, +\fB\%win_wchnstr\fP, +\fB\%mvin_wchstr\fP, +\fB\%mvin_wchnstr\fP, +\fB\%mvwin_wchstr\fP, +\fB\%mvwin_wchnstr\fP \- +get a \fIcurses\fR complex character string from a window .SH SYNOPSIS .nf \fB#include \fP diff --git a/man/curs_inch.3x b/man/curs_inch.3x index 02d2d323..2df5e11a 100644 --- a/man/curs_inch.3x +++ b/man/curs_inch.3x @@ -28,8 +28,8 @@ .\" authorization. * .\"*************************************************************************** .\" -.\" $Id: curs_inch.3x,v 1.33 2023/08/19 20:46:33 tom Exp $ -.TH curs_inch 3X 2023-08-19 "ncurses 6.4" "Library calls" +.\" $Id: curs_inch.3x,v 1.37 2023/09/16 23:37:03 tom Exp $ +.TH curs_inch 3X 2023-09-16 "ncurses 6.4" "Library calls" .ie \n(.g .ds `` \(lq .el .ds `` `` .ie \n(.g .ds '' \(rq @@ -39,10 +39,11 @@ .el .IP \(bu 2 .. .SH NAME -\fBinch\fP, -\fBwinch\fP, -\fBmvinch\fP, -\fBmvwinch\fP \- get a character and attributes from a \fBcurses\fP window +\fB\%inch\fP, +\fB\%winch\fP, +\fB\%mvinch\fP, +\fB\%mvwinch\fP \- +get a \fIcurses\fR character from a window .SH SYNOPSIS \fB#include \fP .sp diff --git a/man/curs_inchstr.3x b/man/curs_inchstr.3x index c05fe820..f174b09f 100644 --- a/man/curs_inchstr.3x +++ b/man/curs_inchstr.3x @@ -27,8 +27,8 @@ .\" authorization. * .\"*************************************************************************** .\" -.\" $Id: curs_inchstr.3x,v 1.28 2023/07/01 15:43:20 tom Exp $ -.TH curs_inchstr 3X 2023-07-01 "ncurses 6.4" "Library calls" +.\" $Id: curs_inchstr.3x,v 1.32 2023/09/16 23:37:03 tom Exp $ +.TH curs_inchstr 3X 2023-09-16 "ncurses 6.4" "Library calls" .ie \n(.g .ds `` \(lq .el .ds `` `` .ie \n(.g .ds '' \(rq @@ -37,19 +37,16 @@ .ie n .IP \(bu 4 .el .IP \(bu 2 .. -.na -.hy 0 .SH NAME -\fBinchstr\fP, -\fBinchnstr\fP, -\fBwinchstr\fP, -\fBwinchnstr\fP, -\fBmvinchstr\fP, -\fBmvinchnstr\fP, -\fBmvwinchstr\fP, -\fBmvwinchnstr\fP \- get a string of characters (and attributes) from a \fBcurses\fP window -.ad -.hy +\fB\%inchstr\fP, +\fB\%inchnstr\fP, +\fB\%winchstr\fP, +\fB\%winchnstr\fP, +\fB\%mvinchstr\fP, +\fB\%mvinchnstr\fP, +\fB\%mvwinchstr\fP, +\fB\%mvwinchnstr\fP \- +get a \fIcurses\fR character string from a window .SH SYNOPSIS \fB#include \fP .sp diff --git a/man/curs_initscr.3x b/man/curs_initscr.3x index 829a50ae..404c2bdc 100644 --- a/man/curs_initscr.3x +++ b/man/curs_initscr.3x @@ -27,8 +27,8 @@ .\" authorization. * .\"*************************************************************************** .\" -.\" $Id: curs_initscr.3x,v 1.45 2023/08/19 19:46:20 tom Exp $ -.TH curs_initscr 3X 2023-08-19 "ncurses 6.4" "Library calls" +.\" $Id: curs_initscr.3x,v 1.50 2023/09/16 23:37:03 tom Exp $ +.TH curs_initscr 3X 2023-09-16 "ncurses 6.4" "Library calls" .de bP .ie n .IP \(bu 4 .el .IP \(bu 2 @@ -37,17 +37,14 @@ .el .ds `` `` .ie \n(.g .ds '' \(rq .el .ds '' '' -.na -.hy 0 .SH NAME -\fBinitscr\fP, -\fBnewterm\fP, -\fBendwin\fP, -\fBisendwin\fP, -\fBset_term\fP, -\fBdelscreen\fP \- \fBcurses\fP screen initialization and manipulation routines -.ad -.hy +\fB\%initscr\fP, +\fB\%newterm\fP, +\fB\%endwin\fP, +\fB\%isendwin\fP, +\fB\%set_term\fP, +\fB\%delscreen\fP \- +initialize, manipulate, or tear down \fIcurses\fR terminal interface .SH SYNOPSIS \fB#include \fP .sp @@ -235,25 +232,23 @@ Generic entries are detected by \fBsetupterm\fP(3X) and cannot be used for full-screen operation. Other implementations may handle a missing/empty TERM variable differently. .SS Signal Handlers -Quoting from X/Open Curses, section 3.1.1: +Quoting from X/Open Curses Issue 7, section 3.1.1: .RS 5 -.hy 0 .PP -.I Curses implementations may provide for special handling of the -.I \fBSIGINT\fP, -.I \fBSIGQUIT\fP and -.I \fBSIGTSTP\fP signals -.I if their disposition is \fBSIG_DFL\fP at the time -\fBinitscr\fI is called \fR... +Curses implementations may provide for special handling of the +\%SIGINT, +\%SIGQUIT, +and \%SIGTSTP signals if their disposition is \%SIG_DFL at the time +.I \%initscr +is called.\|.\|. .PP -.I Any special handling for these signals may remain in effect for the -.I life of the process or until the process changes the disposition of -.I the signal. +Any special handling for these signals may remain in effect for the +life of the process or until the process changes the disposition of +the signal. .PP -.I None of the Curses functions are required to be safe -.I with respect to signals \fP... +None of the Curses functions are required to be safe +with respect to signals.\|.\|. .RE -.hy .PP This implementation establishes signal handlers during initialization, e.g., \fBinitscr\fP or \fBnewterm\fP. diff --git a/man/curs_inopts.3x b/man/curs_inopts.3x index cbce7ef4..8e9b9863 100644 --- a/man/curs_inopts.3x +++ b/man/curs_inopts.3x @@ -28,40 +28,37 @@ .\" authorization. * .\"*************************************************************************** .\" -.\" $Id: curs_inopts.3x,v 1.43 2023/08/19 20:55:23 tom Exp $ -.TH curs_inopts 3X 2023-08-19 "ncurses 6.4" "Library calls" +.\" $Id: curs_inopts.3x,v 1.47 2023/09/16 23:37:03 tom Exp $ +.TH curs_inopts 3X 2023-09-16 "ncurses 6.4" "Library calls" .ie \n(.g .ds `` \(lq .el .ds `` `` .ie \n(.g .ds '' \(rq .el .ds '' '' -.na -.hy 0 .SH NAME -\fBcbreak\fP, -\fBecho\fP, -\fBhalfdelay\fP, -\fBintrflush\fP, -\fBis_cbreak\fP, -\fBis_echo\fP, -\fBis_nl\fP, -\fBis_raw\fP, -\fBkeypad\fP, -\fBmeta\fP, -\fBnl\fP, -\fBnocbreak\fP, -\fBnodelay\fP, -\fBnoecho\fP, -\fBnonl\fP, -\fBnoqiflush\fP, -\fBnoraw\fP, -\fBnotimeout\fP, -\fBqiflush\fP, -\fBraw\fP, -\fBtimeout\fP, -\fBwtimeout\fP, -\fBtypeahead\fP \- \fBcurses\fP input options -.ad -.hy +\fB\%cbreak\fP, +\fB\%echo\fP, +\fB\%halfdelay\fP, +\fB\%intrflush\fP, +\fB\%is_cbreak\fP, +\fB\%is_echo\fP, +\fB\%is_nl\fP, +\fB\%is_raw\fP, +\fB\%keypad\fP, +\fB\%meta\fP, +\fB\%nl\fP, +\fB\%nocbreak\fP, +\fB\%nodelay\fP, +\fB\%noecho\fP, +\fB\%nonl\fP, +\fB\%noqiflush\fP, +\fB\%noraw\fP, +\fB\%notimeout\fP, +\fB\%qiflush\fP, +\fB\%raw\fP, +\fB\%timeout\fP, +\fB\%wtimeout\fP, +\fB\%typeahead\fP \- +get and set \fIcurses\fR terminal input options .SH SYNOPSIS \fB#include \fP .PP diff --git a/man/curs_ins_wch.3x b/man/curs_ins_wch.3x index 42d284af..02104662 100644 --- a/man/curs_ins_wch.3x +++ b/man/curs_ins_wch.3x @@ -1,5 +1,5 @@ .\"*************************************************************************** -.\" Copyright 2019-2021,2022 Thomas E. Dickey * +.\" Copyright 2019-2022,2023 Thomas E. Dickey * .\" Copyright 2002-2010,2017 Free Software Foundation, Inc. * .\" * .\" Permission is hereby granted, free of charge, to any person obtaining a * @@ -27,17 +27,18 @@ .\" authorization. * .\"*************************************************************************** .\" -.\" $Id: curs_ins_wch.3x,v 1.14 2022/02/12 20:05:11 tom Exp $ -.TH curs_ins_wch 3X 2022-02-12 "ncurses 6.4" "Library calls" +.\" $Id: curs_ins_wch.3x,v 1.19 2023/09/16 23:37:03 tom Exp $ +.TH curs_ins_wch 3X 2023-09-16 "ncurses 6.4" "Library calls" .ie \n(.g .ds `` \(lq .el .ds `` `` .ie \n(.g .ds '' \(rq .el .ds '' '' .SH NAME -\fBins_wch\fP, -\fBmvins_wch\fP, -\fBmvwins_wch\fP, -\fBwins_wch\fP \- insert a complex character and rendition into a window +\fB\%ins_wch\fP, +\fB\%mvins_wch\fP, +\fB\%mvwins_wch\fP, +\fB\%wins_wch\fP \- +insert a \fIcurses\fR complex character string in a window .SH SYNOPSIS #include .sp diff --git a/man/curs_ins_wstr.3x b/man/curs_ins_wstr.3x index e1c14571..64856070 100644 --- a/man/curs_ins_wstr.3x +++ b/man/curs_ins_wstr.3x @@ -1,5 +1,5 @@ .\"*************************************************************************** -.\" Copyright 2019-2021,2022 Thomas E. Dickey * +.\" Copyright 2019-2022,2023 Thomas E. Dickey * .\" Copyright 2002-2012,2017 Free Software Foundation, Inc. * .\" * .\" Permission is hereby granted, free of charge, to any person obtaining a * @@ -27,25 +27,22 @@ .\" authorization. * .\"*************************************************************************** .\" -.\" $Id: curs_ins_wstr.3x,v 1.15 2022/02/12 20:05:11 tom Exp $ -.TH curs_ins_wstr 3X 2022-02-12 "ncurses 6.4" "Library calls" +.\" $Id: curs_ins_wstr.3x,v 1.20 2023/09/16 23:37:03 tom Exp $ +.TH curs_ins_wstr 3X 2023-09-16 "ncurses 6.4" "Library calls" .ie \n(.g .ds `` \(lq .el .ds `` `` .ie \n(.g .ds '' \(rq .el .ds '' '' -.na -.hy 0 .SH NAME -\fBins_wstr\fP, -\fBins_nwstr\fP, -\fBwins_wstr\fP, -\fBwins_nwstr\fP, -\fBmvins_wstr\fP, -\fBmvins_nwstr\fP, -\fBmvwins_wstr\fP, -\fBmvwins_nwstr\fP \- insert a wide-character string into a curses window -.ad -.hy +\fB\%ins_wstr\fP, +\fB\%ins_nwstr\fP, +\fB\%wins_wstr\fP, +\fB\%wins_nwstr\fP, +\fB\%mvins_wstr\fP, +\fB\%mvins_nwstr\fP, +\fB\%mvwins_wstr\fP, +\fB\%mvwins_nwstr\fP \- +insert a wide-character string in a \fIcurses\fR window .SH SYNOPSIS .nf \fB#include \fP diff --git a/man/curs_insch.3x b/man/curs_insch.3x index d5631958..4a808607 100644 --- a/man/curs_insch.3x +++ b/man/curs_insch.3x @@ -27,17 +27,18 @@ .\" authorization. * .\"*************************************************************************** .\" -.\" $Id: curs_insch.3x,v 1.26 2023/07/01 15:43:20 tom Exp $ -.TH curs_insch 3X 2023-07-01 "ncurses 6.4" "Library calls" +.\" $Id: curs_insch.3x,v 1.30 2023/09/16 23:37:03 tom Exp $ +.TH curs_insch 3X 2023-09-16 "ncurses 6.4" "Library calls" .ie \n(.g .ds `` \(lq .el .ds `` `` .ie \n(.g .ds '' \(rq .el .ds '' '' .SH NAME -\fBinsch\fP, -\fBwinsch\fP, -\fBmvinsch\fP, -\fBmvwinsch\fP \- insert a character before cursor in a \fBcurses\fP window +\fB\%insch\fP, +\fB\%winsch\fP, +\fB\%mvinsch\fP, +\fB\%mvwinsch\fP \- +insert a \fIcurses\fR character in a window .SH SYNOPSIS \fB#include \fP .sp diff --git a/man/curs_insstr.3x b/man/curs_insstr.3x index b2b56394..2621bfe5 100644 --- a/man/curs_insstr.3x +++ b/man/curs_insstr.3x @@ -27,21 +27,22 @@ .\" authorization. * .\"*************************************************************************** .\" -.\" $Id: curs_insstr.3x,v 1.33 2023/07/01 15:43:20 tom Exp $ -.TH curs_insstr 3X 2023-07-01 "ncurses 6.4" "Library calls" +.\" $Id: curs_insstr.3x,v 1.37 2023/09/16 23:37:03 tom Exp $ +.TH curs_insstr 3X 2023-09-16 "ncurses 6.4" "Library calls" .ie \n(.g .ds `` \(lq .el .ds `` `` .ie \n(.g .ds '' \(rq .el .ds '' '' .SH NAME -\fBinsstr\fP, -\fBinsnstr\fP, -\fBwinsstr\fP, -\fBwinsnstr\fP, -\fBmvinsstr\fP, -\fBmvinsnstr\fP, -\fBmvwinsstr\fP, -\fBmvwinsnstr\fP \- insert string before cursor in a \fBcurses\fP window +\fB\%insstr\fP, +\fB\%insnstr\fP, +\fB\%winsstr\fP, +\fB\%winsnstr\fP, +\fB\%mvinsstr\fP, +\fB\%mvinsnstr\fP, +\fB\%mvwinsstr\fP, +\fB\%mvwinsnstr\fP \- +insert a string in a \fIcurses\fR window .SH SYNOPSIS \fB#include \fP .br diff --git a/man/curs_instr.3x b/man/curs_instr.3x index fab97c94..fbbf1782 100644 --- a/man/curs_instr.3x +++ b/man/curs_instr.3x @@ -27,8 +27,8 @@ .\" authorization. * .\"*************************************************************************** .\" -.\" $Id: curs_instr.3x,v 1.29 2023/07/01 15:43:20 tom Exp $ -.TH curs_instr 3X 2023-07-01 "ncurses 6.4" "Library calls" +.\" $Id: curs_instr.3x,v 1.33 2023/09/16 23:37:03 tom Exp $ +.TH curs_instr 3X 2023-09-16 "ncurses 6.4" "Library calls" .ie \n(.g .ds `` \(lq .el .ds `` `` .ie \n(.g .ds '' \(rq @@ -38,14 +38,15 @@ .el .IP \(bu 2 .. .SH NAME -\fBinstr\fP, -\fBinnstr\fP, -\fBwinstr\fP, -\fBwinnstr\fP, -\fBmvinstr\fP, -\fBmvinnstr\fP, -\fBmvwinstr\fP, -\fBmvwinnstr\fP \- get a string of characters from a \fBcurses\fP window +\fB\%instr\fP, +\fB\%innstr\fP, +\fB\%winstr\fP, +\fB\%winnstr\fP, +\fB\%mvinstr\fP, +\fB\%mvinnstr\fP, +\fB\%mvwinstr\fP, +\fB\%mvwinnstr\fP \- +get a string from a \fIcurses\fR window .SH SYNOPSIS \fB#include \fP .sp diff --git a/man/curs_inwstr.3x b/man/curs_inwstr.3x index 7022b91a..fa283a8c 100644 --- a/man/curs_inwstr.3x +++ b/man/curs_inwstr.3x @@ -27,21 +27,22 @@ .\" authorization. * .\"*************************************************************************** .\" -.\" $Id: curs_inwstr.3x,v 1.21 2023/07/01 15:43:20 tom Exp $ -.TH curs_inwstr 3X 2023-07-01 "ncurses 6.4" "Library calls" +.\" $Id: curs_inwstr.3x,v 1.25 2023/09/16 23:37:03 tom Exp $ +.TH curs_inwstr 3X 2023-09-16 "ncurses 6.4" "Library calls" .ie \n(.g .ds `` \(lq .el .ds `` `` .ie \n(.g .ds '' \(rq .el .ds '' '' .SH NAME -\fBinwstr\fP, -\fBinnwstr\fP, -\fBwinwstr\fP, -\fBwinnwstr\fP, -\fBmvinwstr\fP, -\fBmvinnwstr\fP, -\fBmvwinwstr\fP, -\fBmvwinnwstr\fP \- get a string of \fBwchar_t\fP characters from a curses window +\fB\%inwstr\fP, +\fB\%innwstr\fP, +\fB\%winwstr\fP, +\fB\%winnwstr\fP, +\fB\%mvinwstr\fP, +\fB\%mvinnwstr\fP, +\fB\%mvwinwstr\fP, +\fB\%mvwinnwstr\fP \- +get a wide-character string from a \fIcurses\fR window .SH SYNOPSIS .nf \fB#include \fP diff --git a/man/curs_kernel.3x b/man/curs_kernel.3x index 14c90522..6692479f 100644 --- a/man/curs_kernel.3x +++ b/man/curs_kernel.3x @@ -27,7 +27,8 @@ .\" authorization. * .\"*************************************************************************** .\" -.\" $Id: curs_kernel.3x,v 1.37 2023/08/19 19:47:16 tom Exp $ +.\" $Id: curs_kernel.3x,v 1.44 2023/09/16 23:37:03 tom Exp $ +.TH curs_kernel 3X 2023-09-16 "ncurses 6.4" "Library calls" .ie \n(.g .ds `` \(lq .el .ds `` `` .ie \n(.g .ds '' \(rq @@ -36,23 +37,19 @@ .ie n .IP \(bu 4 .el .IP \(bu 2 .. -.TH curs_kernel 3X 2023-08-19 "ncurses 6.4" "Library calls" -.na -.hy 0 .SH NAME -\fBdef_prog_mode\fP, -\fBdef_shell_mode\fP, -\fBreset_prog_mode\fP, -\fBreset_shell_mode\fP, -\fBresetty\fP, -\fBsavetty\fP, -\fBgetsyx\fP, -\fBsetsyx\fP, -\fBripoffline\fP, -\fBcurs_set\fP, -\fBnapms\fP \- low-level \fBcurses\fP routines -.ad -.hy +\fB\%def_prog_mode\fP, +\fB\%def_shell_mode\fP, +\fB\%reset_prog_mode\fP, +\fB\%reset_shell_mode\fP, +\fB\%resetty\fP, +\fB\%savetty\fP, +\fB\%getsyx\fP, +\fB\%setsyx\fP, +\fB\%ripoffline\fP, +\fB\%curs_set\fP, +\fB\%napms\fP \- +low-level \fIcurses\fR routines .SH SYNOPSIS \fB#include \fP .sp @@ -177,18 +174,14 @@ requested \fIvisibility\fP is not supported. X/Open defines no error conditions. In this implementation .TP 5 -.na -.hy 0 \fBdef_prog_mode\fP, \fBdef_shell_mode\fP, \fBreset_prog_mode\fP, \fBreset_shell_mode\fP -.hy -.ad return an error if the terminal was not initialized, or if the I/O call to obtain the terminal settings fails. .TP 5 \fBripoffline\fP returns an error if the maximum number of ripped-off lines -exceeds the maximum (NRIPS = 5). +exceeds the maximum (5). .SH NOTES Note that \fBgetsyx\fP is a macro, so \fB&\fP is not necessary before the variables \fIy\fP and \fIx\fP. diff --git a/man/curs_legacy.3x b/man/curs_legacy.3x index 5eaee795..86c0176f 100644 --- a/man/curs_legacy.3x +++ b/man/curs_legacy.3x @@ -27,14 +27,23 @@ .\" authorization. * .\"*************************************************************************** .\" -.\" $Id: curs_legacy.3x,v 1.17 2023/07/01 15:43:20 tom Exp $ +.\" $Id: curs_legacy.3x,v 1.22 2023/09/16 23:37:03 tom Exp $ +.TH curs_legacy 3X 2023-09-16 "ncurses 6.4" "Library calls" .de bP .ie n .IP \(bu 4 .el .IP \(bu 2 .. -.TH curs_legacy 3X 2023-07-01 "ncurses 6.4" "Library calls" .SH NAME -curs_legacy \- get \fBcurses\fP cursor and window coordinates, attributes +\fB\%getattrs\fP, +\fB\%getbegx\fP, +\fB\%getbegy\fP, +\fB\%getcurx\fP, +\fB\%getcury\fP, +\fB\%getmaxx\fP, +\fB\%getmaxy\fP, +\fB\%getparx\fP, +\fB\%getpary\fP \- +get \fIcurses\fR cursor and window coordinates or attributes (legacy) .SH SYNOPSIS \fB#include \fP .sp diff --git a/man/curs_memleaks.3x b/man/curs_memleaks.3x index 1cd1dc92..c04598a9 100644 --- a/man/curs_memleaks.3x +++ b/man/curs_memleaks.3x @@ -1,5 +1,5 @@ .\"*************************************************************************** -.\" Copyright 2019-2021,2022 Thomas E. Dickey * +.\" Copyright 2019-2022,2023 Thomas E. Dickey * .\" Copyright 2008-2010,2017 Free Software Foundation, Inc. * .\" * .\" Permission is hereby granted, free of charge, to any person obtaining a * @@ -27,8 +27,8 @@ .\" authorization. * .\"*************************************************************************** .\" -.\" $Id: curs_memleaks.3x,v 1.16 2022/06/04 23:33:48 tom Exp $ -.TH curs_memleaks 3X 2022-06-04 "ncurses 6.4" "Library calls" +.\" $Id: curs_memleaks.3x,v 1.21 2023/09/16 23:37:03 tom Exp $ +.TH curs_memleaks 3X 2023-09-16 "ncurses 6.4" "Library calls" .ie \n(.g .ds `` \(lq .el .ds `` `` .ie \n(.g .ds '' \(rq @@ -37,13 +37,10 @@ .ie n .IP \(bu 4 .el .IP \(bu 2 .. -.na -.hy 0 .SH NAME -\fBexit_curses\fP, -\fBexit_terminfo\fP \- \fBcurses\fP memory-leak checking -.ad -.hy +\fB\%exit_curses\fP, +\fB\%exit_terminfo\fP \- +check for memory leaks in \fIcurses\fR .SH SYNOPSIS \fB#include \fP .br diff --git a/man/curs_mouse.3x b/man/curs_mouse.3x index 731e6e5e..31d128f3 100644 --- a/man/curs_mouse.3x +++ b/man/curs_mouse.3x @@ -28,7 +28,8 @@ .\" authorization. * .\"*************************************************************************** .\" -.\" $Id: curs_mouse.3x,v 1.66 2023/09/09 21:13:51 tom Exp $ +.\" $Id: curs_mouse.3x,v 1.71 2023/09/16 23:37:03 tom Exp $ +.TH curs_mouse 3X 2023-09-16 "ncurses 6.4" "Library calls" .ie \n(.g .ds `` \(lq .el .ds `` `` .ie \n(.g .ds '' \(rq @@ -56,17 +57,16 @@ .ie n .IP \(bu 4 .el .IP \(bu 2 .. -.TH curs_mouse 3X 2023-09-09 "ncurses 6.4" "Library calls" -.na -.hy 0 .SH NAME -\fBhas_mouse\fP, -\fBgetmouse\fP, \fBungetmouse\fP, -\fBmousemask\fP, \fBwenclose\fP, -\fBmouse_trafo\fP, \fBwmouse_trafo\fP, -\fBmouseinterval\fP \- mouse interface through curses -.ad -.hy +\fB\%has_mouse\fP, +\fB\%getmouse\fP, +\fB\%ungetmouse\fP, +\fB\%mousemask\fP, +\fB\%wenclose\fP, +\fB\%mouse_trafo\fP, +\fB\%wmouse_trafo\fP, +\fB\%mouseinterval\fP \- +get mouse events in \fIcurses\fR .SH SYNOPSIS \fB#include \fP .PP diff --git a/man/curs_move.3x b/man/curs_move.3x index 26490809..7ac46740 100644 --- a/man/curs_move.3x +++ b/man/curs_move.3x @@ -27,15 +27,12 @@ .\" authorization. * .\"*************************************************************************** .\" -.\" $Id: curs_move.3x,v 1.26 2023/07/01 15:43:20 tom Exp $ -.TH curs_move 3X 2023-07-01 "ncurses 6.4" "Library calls" -.na -.hy 0 +.\" $Id: curs_move.3x,v 1.29 2023/09/16 20:18:53 tom Exp $ +.TH curs_move 3X 2023-09-16 "ncurses 6.4" "Library calls" .SH NAME -\fBmove\fP, -\fBwmove\fP \- move \fBcurses\fP window cursor -.ad -.hy +\fB\%move\fP, +\fB\%wmove\fP \- +move cursor in a \fIcurses\fR window .SH SYNOPSIS \fB#include \fP .sp diff --git a/man/curs_opaque.3x b/man/curs_opaque.3x index ef6a1933..e7f8561d 100644 --- a/man/curs_opaque.3x +++ b/man/curs_opaque.3x @@ -27,32 +27,29 @@ .\" authorization. * .\"*************************************************************************** .\" -.\" $Id: curs_opaque.3x,v 1.23 2023/07/01 14:31:54 tom Exp $ -.TH curs_opaque 3X 2023-07-01 "ncurses 6.4" "Library calls" +.\" $Id: curs_opaque.3x,v 1.27 2023/09/16 23:37:03 tom Exp $ +.TH curs_opaque 3X 2023-09-16 "ncurses 6.4" "Library calls" .ie \n(.g .ds `` \(lq .el .ds `` `` .ie \n(.g .ds '' \(rq .el .ds '' '' -.na -.hy 0 .SH NAME -\fBis_cleared\fP, -\fBis_idlok\fP, -\fBis_idcok\fP, -\fBis_immedok\fP, -\fBis_keypad\fP, -\fBis_leaveok\fP, -\fBis_nodelay\fP, -\fBis_notimeout\fP, -\fBis_pad\fP, -\fBis_scrollok\fP, -\fBis_subwin\fP, -\fBis_syncok\fP, -\fBwgetdelay\fP, -\fBwgetparent\fP, -\fBwgetscrreg\fP \- \fBcurses\fP window properties -.ad -.hy +\fB\%is_cleared\fP, +\fB\%is_idlok\fP, +\fB\%is_idcok\fP, +\fB\%is_immedok\fP, +\fB\%is_keypad\fP, +\fB\%is_leaveok\fP, +\fB\%is_nodelay\fP, +\fB\%is_notimeout\fP, +\fB\%is_pad\fP, +\fB\%is_scrollok\fP, +\fB\%is_subwin\fP, +\fB\%is_syncok\fP, +\fB\%wgetdelay\fP, +\fB\%wgetparent\fP, +\fB\%wgetscrreg\fP \- +obtain \fIcurses\fR window properties .SH SYNOPSIS \fB#include \fP .sp diff --git a/man/curs_outopts.3x b/man/curs_outopts.3x index 3d12eff4..3f7eb90e 100644 --- a/man/curs_outopts.3x +++ b/man/curs_outopts.3x @@ -27,25 +27,22 @@ .\" authorization. * .\"*************************************************************************** .\" -.\" $Id: curs_outopts.3x,v 1.40 2023/07/01 15:43:20 tom Exp $ -.TH curs_outopts 3X 2023-07-01 "ncurses 6.4" "Library calls" -.na -.hy 0 +.\" $Id: curs_outopts.3x,v 1.44 2023/09/16 23:37:03 tom Exp $ +.TH curs_outopts 3X 2023-09-16 "ncurses 6.4" "Library calls" .de bP .ie n .IP \(bu 4 .el .IP \(bu 2 .. .SH NAME -\fBclearok\fP, -\fBidlok\fP, -\fBidcok\fP, -\fBimmedok\fP, -\fBleaveok\fP, -\fBsetscrreg\fP, -\fBwsetscrreg\fP, -\fBscrollok\fP \- \fBcurses\fP output options -.ad -.hy +\fB\%clearok\fP, +\fB\%idlok\fP, +\fB\%idcok\fP, +\fB\%immedok\fP, +\fB\%leaveok\fP, +\fB\%setscrreg\fP, +\fB\%wsetscrreg\fP, +\fB\%scrollok\fP \- +set \fIcurses\fR output options .SH SYNOPSIS \fB#include \fP .sp diff --git a/man/curs_overlay.3x b/man/curs_overlay.3x index 334bf4fb..6f98fc71 100644 --- a/man/curs_overlay.3x +++ b/man/curs_overlay.3x @@ -27,16 +27,13 @@ .\" authorization. * .\"*************************************************************************** .\" -.\" $Id: curs_overlay.3x,v 1.26 2023/07/01 15:43:20 tom Exp $ -.TH curs_overlay 3X 2023-07-01 "ncurses 6.4" "Library calls" -.na -.hy 0 +.\" $Id: curs_overlay.3x,v 1.30 2023/09/16 23:37:03 tom Exp $ +.TH curs_overlay 3X 2023-09-16 "ncurses 6.4" "Library calls" .SH NAME -\fBoverlay\fP, -\fBoverwrite\fP, -\fBcopywin\fP \- overlay and manipulate overlapped \fBcurses\fP windows -.ad -.hy +\fB\%overlay\fP, +\fB\%overwrite\fP, +\fB\%copywin\fP \- +overlay \fIcurses\fR windows and manipulate them .SH SYNOPSIS \fB#include \fP .sp diff --git a/man/curs_pad.3x b/man/curs_pad.3x index b6948410..28dbc7b7 100644 --- a/man/curs_pad.3x +++ b/man/curs_pad.3x @@ -27,23 +27,20 @@ .\" authorization. * .\"*************************************************************************** .\" -.\" $Id: curs_pad.3x,v 1.33 2023/07/01 15:43:20 tom Exp $ +.\" $Id: curs_pad.3x,v 1.38 2023/09/16 23:37:03 tom Exp $ +.TH curs_pad 3X 2023-09-16 "ncurses 6.4" "Library calls" .de bP .ie n .IP \(bu 4 .el .IP \(bu 2 .. -.TH curs_pad 3X 2023-07-01 "ncurses 6.4" "Library calls" -.na -.hy 0 .SH NAME -\fBnewpad\fP, -\fBsubpad\fP, -\fBprefresh\fP, -\fBpnoutrefresh\fP, -\fBpechochar\fP, -\fBpecho_wchar\fP \- create and display \fBcurses\fP pads -.ad -.hy +\fB\%newpad\fP, +\fB\%subpad\fP, +\fB\%prefresh\fP, +\fB\%pnoutrefresh\fP, +\fB\%pechochar\fP, +\fB\%pecho_wchar\fP \- +create and display \fIcurses\fR pads .SH SYNOPSIS \fB#include \fP .sp diff --git a/man/curs_print.3x b/man/curs_print.3x index bbaeaa90..3325958e 100644 --- a/man/curs_print.3x +++ b/man/curs_print.3x @@ -1,5 +1,5 @@ .\"*************************************************************************** -.\" Copyright 2018-2021,2022 Thomas E. Dickey * +.\" Copyright 2018-2022,2023 Thomas E. Dickey * .\" Copyright 1998-2010,2017 Free Software Foundation, Inc. * .\" * .\" Permission is hereby granted, free of charge, to any person obtaining a * @@ -27,10 +27,11 @@ .\" authorization. * .\"*************************************************************************** .\" -.\" $Id: curs_print.3x,v 1.20 2022/02/12 20:05:11 tom Exp $ -.TH curs_print 3X 2022-02-12 "ncurses 6.4" "Library calls" +.\" $Id: curs_print.3x,v 1.25 2023/09/16 23:37:03 tom Exp $ +.TH curs_print 3X 2023-09-16 "ncurses 6.4" "Library calls" .SH NAME -\fBmcprint\fP \- ship binary data to printer +\fB\%mcprint\fP \- +write binary data to printer using \fIterminfo\fR capabilities .SH SYNOPSIS \fB#include \fP .sp diff --git a/man/curs_printw.3x b/man/curs_printw.3x index 985fbe25..9f804a45 100644 --- a/man/curs_printw.3x +++ b/man/curs_printw.3x @@ -1,5 +1,5 @@ .\"*************************************************************************** -.\" Copyright 2018-2021,2022 Thomas E. Dickey * +.\" Copyright 2018-2022,2023 Thomas E. Dickey * .\" Copyright 1998-2010,2017 Free Software Foundation, Inc. * .\" * .\" Permission is hereby granted, free of charge, to any person obtaining a * @@ -27,8 +27,8 @@ .\" authorization. * .\"*************************************************************************** .\" -.\" $Id: curs_printw.3x,v 1.33 2022/02/12 20:05:11 tom Exp $ -.TH curs_printw 3X 2022-02-12 "ncurses 6.4" "Library calls" +.\" $Id: curs_printw.3x,v 1.38 2023/09/16 23:37:03 tom Exp $ +.TH curs_printw 3X 2023-09-16 "ncurses 6.4" "Library calls" .ie \n(.g .ds `` \(lq .el .ds `` `` .ie \n(.g .ds '' \(rq @@ -37,16 +37,14 @@ .ie n .IP \(bu 4 .el .IP \(bu 2 .. -.na -.hy 0 .SH NAME -\fBprintw\fP, -\fBwprintw\fP, -\fBmvprintw\fP, -\fBmvwprintw\fP, -\fBvwprintw\fP, \fBvw_printw\fP \- print formatted output in \fBcurses\fP windows -.ad -.hy +\fB\%printw\fP, +\fB\%wprintw\fP, +\fB\%mvprintw\fP, +\fB\%mvwprintw\fP, +\fB\%vwprintw\fP, +\fB\%vw_printw\fP \- +write formatted output to \fIcurses\fR windows .SH SYNOPSIS \fB#include \fP .sp diff --git a/man/curs_refresh.3x b/man/curs_refresh.3x index 90d18ea7..e458b128 100644 --- a/man/curs_refresh.3x +++ b/man/curs_refresh.3x @@ -27,8 +27,8 @@ .\" authorization. * .\"*************************************************************************** .\" -.\" $Id: curs_refresh.3x,v 1.31 2023/08/19 19:47:40 tom Exp $ -.TH curs_refresh 3X 2023-08-19 "ncurses 6.4" "Library calls" +.\" $Id: curs_refresh.3x,v 1.35 2023/09/16 23:37:03 tom Exp $ +.TH curs_refresh 3X 2023-09-16 "ncurses 6.4" "Library calls" .ie \n(.g .ds `` \(lq .el .ds `` `` .ie \n(.g .ds '' \(rq @@ -37,17 +37,14 @@ .ie n .IP \(bu 4 .el .IP \(bu 2 .. -.na -.hy 0 .SH NAME -\fBdoupdate\fP, -\fBredrawwin\fP, -\fBrefresh\fP, -\fBwnoutrefresh\fP, -\fBwredrawln\fP, -\fBwrefresh\fP \- refresh \fBcurses\fP windows and lines -.ad -.hy +\fB\%doupdate\fP, +\fB\%redrawwin\fP, +\fB\%refresh\fP, +\fB\%wnoutrefresh\fP, +\fB\%wredrawln\fP, +\fB\%wrefresh\fP \- +refresh \fIcurses\fR windows or lines thereupon .SH SYNOPSIS \fB#include \fP .sp diff --git a/man/curs_scanw.3x b/man/curs_scanw.3x index fe499b4e..9aff66fa 100644 --- a/man/curs_scanw.3x +++ b/man/curs_scanw.3x @@ -1,5 +1,5 @@ .\"*************************************************************************** -.\" Copyright 2018-2021,2022 Thomas E. Dickey * +.\" Copyright 2018-2022,2023 Thomas E. Dickey * .\" Copyright 1998-2010,2017 Free Software Foundation, Inc. * .\" * .\" Permission is hereby granted, free of charge, to any person obtaining a * @@ -27,8 +27,8 @@ .\" authorization. * .\"*************************************************************************** .\" -.\" $Id: curs_scanw.3x,v 1.33 2022/02/12 20:05:11 tom Exp $ -.TH curs_scanw 3X 2022-02-12 "ncurses 6.4" "Library calls" +.\" $Id: curs_scanw.3x,v 1.38 2023/09/16 23:37:03 tom Exp $ +.TH curs_scanw 3X 2023-09-16 "ncurses 6.4" "Library calls" .ie \n(.g .ds `` \(lq .el .ds `` `` .ie \n(.g .ds '' \(rq @@ -38,11 +38,13 @@ .el .IP \(bu 2 .. .SH NAME -\fBscanw\fP, -\fBwscanw\fP, -\fBmvscanw\fP, -\fBmvwscanw\fP, -\fBvwscanw\fP, \fBvw_scanw\fP \- convert formatted input from a \fBcurses\fP window +\fB\%scanw\fP, +\fB\%wscanw\fP, +\fB\%mvscanw\fP, +\fB\%mvwscanw\fP, +\fB\%vwscanw\fP, +\fB\%vw_scanw\fP \- +read formatted input from a \fIcurses\fR window .SH SYNOPSIS \fB#include \fP .sp diff --git a/man/curs_scr_dump.3x b/man/curs_scr_dump.3x index ff9d8702..fb74acba 100644 --- a/man/curs_scr_dump.3x +++ b/man/curs_scr_dump.3x @@ -27,8 +27,8 @@ .\" authorization. * .\"*************************************************************************** .\" -.\" $Id: curs_scr_dump.3x,v 1.24 2023/07/01 15:43:20 tom Exp $ -.TH curs_scr_dump 3X 2023-07-01 "ncurses 6.4" "Library calls" +.\" $Id: curs_scr_dump.3x,v 1.28 2023/09/16 23:37:03 tom Exp $ +.TH curs_scr_dump 3X 2023-09-16 "ncurses 6.4" "Library calls" .ie \n(.g .ds `` \(lq .el .ds `` `` .ie \n(.g .ds '' \(rq @@ -37,15 +37,12 @@ .ie n .IP \(bu 4 .el .IP \(bu 2 .. -.na -.hy 0 .SH NAME -\fBscr_dump\fP, -\fBscr_restore\fP, -\fBscr_init\fP, -\fBscr_set\fP \- read (write) a \fBcurses\fP screen from (to) a file -.ad -.hy +\fB\%scr_dump\fP, +\fB\%scr_restore\fP, +\fB\%scr_init\fP, +\fB\%scr_set\fP \- +read/write a \fIcurses\fR screen from/to a file .SH SYNOPSIS \fB#include \fP .sp diff --git a/man/curs_scroll.3x b/man/curs_scroll.3x index 444cb48f..135183ad 100644 --- a/man/curs_scroll.3x +++ b/man/curs_scroll.3x @@ -27,20 +27,17 @@ .\" authorization. * .\"*************************************************************************** .\" -.\" $Id: curs_scroll.3x,v 1.28 2023/08/19 19:47:52 tom Exp $ -.TH curs_scroll 3X 2023-08-19 "ncurses 6.4" "Library calls" +.\" $Id: curs_scroll.3x,v 1.32 2023/09/16 23:37:03 tom Exp $ +.TH curs_scroll 3X 2023-09-16 "ncurses 6.4" "Library calls" .ie \n(.g .ds `` \(lq .el .ds `` `` .ie \n(.g .ds '' \(rq .el .ds '' '' -.na -.hy 0 .SH NAME -\fBscroll\fP, -\fBscrl\fP, -\fBwscrl\fP \- scroll a \fBcurses\fP window -.ad -.hy +\fB\%scroll\fP, +\fB\%scrl\fP, +\fB\%wscrl\fP \- +scroll a \fIcurses\fR window .SH SYNOPSIS \fB#include \fP .sp diff --git a/man/curs_slk.3x b/man/curs_slk.3x index 56324f9a..50b477ac 100644 --- a/man/curs_slk.3x +++ b/man/curs_slk.3x @@ -27,8 +27,8 @@ .\" authorization. * .\"*************************************************************************** .\" -.\" $Id: curs_slk.3x,v 1.48 2023/07/01 15:43:20 tom Exp $ -.TH curs_slk 3X 2023-07-01 "ncurses 6.4" "Library calls" +.\" $Id: curs_slk.3x,v 1.53 2023/09/16 23:37:03 tom Exp $ +.TH curs_slk 3X 2023-09-16 "ncurses 6.4" "Library calls" .ie \n(.g .ds `` \(lq .el .ds `` `` .ie \n(.g .ds '' \(rq @@ -37,29 +37,26 @@ .ie n .IP \(bu 4 .el .IP \(bu 2 .. -.na -.hy 0 .SH NAME -\fBslk_init\fP, -\fBslk_set\fP, -\fBslk_wset\fP, -\fBslk_refresh\fP, -\fBslk_noutrefresh\fP, -\fBslk_label\fP, -\fBslk_clear\fP, -\fBslk_restore\fP, -\fBslk_touch\fP, -\fBslk_attron\fP, -\fBslk_attrset\fP, -\fBslk_attroff\fP, -\fBslk_attr_on\fP, -\fBslk_attr_set\fP, -\fBslk_attr_off\fP, -\fBslk_attr\fP, -\fBslk_color\fP, -\fBextended_slk_color\fP \- \fBcurses\fP soft label routines -.ad -.hy +\fB\%slk_init\fP, +\fB\%slk_set\fP, +\fB\%slk_wset\fP, +\fB\%slk_refresh\fP, +\fB\%slk_noutrefresh\fP, +\fB\%slk_label\fP, +\fB\%slk_clear\fP, +\fB\%slk_restore\fP, +\fB\%slk_touch\fP, +\fB\%slk_attron\fP, +\fB\%slk_attrset\fP, +\fB\%slk_attroff\fP, +\fB\%slk_attr_on\fP, +\fB\%slk_attr_set\fP, +\fB\%slk_attr_off\fP, +\fB\%slk_attr\fP, +\fB\%slk_color\fP, +\fB\%extended_slk_color\fP \- +\fIcurses\fR soft label key routines .SH SYNOPSIS \fB#include \fP .sp @@ -208,11 +205,7 @@ In this implementation \fBslk_attr\fP returns the attribute used for the soft keys. .TP 5 -.na -.hy 0 \fBslk_attroff\fP, \fBslk_attron\fP, \fBslk_clear\fP, \fBslk_noutrefresh\fP, \fBslk_refresh\fP, \fBslk_touch\fP -.ad -.hy return an error if the terminal or the softkeys were not initialized. .TP 5 diff --git a/man/curs_sp_funcs.3x b/man/curs_sp_funcs.3x index 2cbc587b..d22a9ef6 100644 --- a/man/curs_sp_funcs.3x +++ b/man/curs_sp_funcs.3x @@ -27,18 +27,15 @@ .\" authorization. * .\"*************************************************************************** .\" -.\" $Id: curs_sp_funcs.3x,v 1.33 2023/08/19 19:48:07 tom Exp $ -.TH curs_sp_funcs 3X 2023-08-19 "ncurses 6.4" "Library calls" +.\" $Id: curs_sp_funcs.3x,v 1.37 2023/09/16 23:37:03 tom Exp $ +.TH curs_sp_funcs 3X 2023-09-16 "ncurses 6.4" "Library calls" .ie \n(.g .ds `` \(lq .el .ds `` `` .ie \n(.g .ds '' \(rq .el .ds '' '' -.na -.hy 0 .SH NAME -curs_sp_funcs \- \fBcurses\fP screen-pointer extension -.ad -.hy +\fB\%curs_sp_funcs\fP \- +\fIcurses\fR screen-pointer extension .SH SYNOPSIS \fB#include \fP .nf diff --git a/man/curs_termattrs.3x b/man/curs_termattrs.3x index 12173473..1f529b5d 100644 --- a/man/curs_termattrs.3x +++ b/man/curs_termattrs.3x @@ -27,20 +27,21 @@ .\" authorization. * .\"*************************************************************************** .\" -.\" $Id: curs_termattrs.3x,v 1.24 2023/07/01 14:31:54 tom Exp $ -.TH curs_termattrs 3X 2023-07-01 "ncurses 6.4" "Library calls" +.\" $Id: curs_termattrs.3x,v 1.28 2023/09/16 23:37:03 tom Exp $ +.TH curs_termattrs 3X 2023-09-16 "ncurses 6.4" "Library calls" .SH NAME -\fBbaudrate\fP, -\fBerasechar\fP, -\fBerasewchar\fP, -\fBhas_ic\fP, -\fBhas_il\fP, -\fBkillchar\fP, -\fBkillwchar\fP, -\fBlongname\fP, -\fBterm_attrs\fP, -\fBtermattrs\fP, -\fBtermname\fP \- \fBcurses\fP environment query routines +\fB\%baudrate\fP, +\fB\%erasechar\fP, +\fB\%erasewchar\fP, +\fB\%has_ic\fP, +\fB\%has_il\fP, +\fB\%killchar\fP, +\fB\%killwchar\fP, +\fB\%longname\fP, +\fB\%term_attrs\fP, +\fB\%termattrs\fP, +\fB\%termname\fP \- +\fIcurses\fR environment query routines .SH SYNOPSIS \fB#include \fP .PP diff --git a/man/curs_termcap.3x b/man/curs_termcap.3x index f26a536c..8e1fd7b8 100644 --- a/man/curs_termcap.3x +++ b/man/curs_termcap.3x @@ -27,8 +27,8 @@ .\" authorization. * .\"*************************************************************************** .\" -.\" $Id: curs_termcap.3x,v 1.62 2023/07/01 15:28:47 tom Exp $ -.TH curs_termcap 3X 2023-07-01 "ncurses 6.4" "Library calls" +.\" $Id: curs_termcap.3x,v 1.66 2023/09/16 23:37:03 tom Exp $ +.TH curs_termcap 3X 2023-09-16 "ncurses 6.4" "Library calls" .ie \n(.g .ds `` \(lq .el .ds `` `` .ie \n(.g .ds '' \(rq @@ -37,22 +37,19 @@ .ie n .IP \(bu 4 .el .IP \(bu 2 .. -.na -.hy 0 .ds n 5 .SH NAME -\fBPC\fP, -\fBUP\fP, -\fBBC\fP, -\fBospeed\fP, -\fBtgetent\fP, -\fBtgetflag\fP, -\fBtgetnum\fP, -\fBtgetstr\fP, -\fBtgoto\fP, -\fBtputs\fP \- \fBcurses\fP emulation of termcap -.ad -.hy +\fB\%PC\fP, +\fB\%UP\fP, +\fB\%BC\fP, +\fB\%ospeed\fP, +\fB\%tgetent\fP, +\fB\%tgetflag\fP, +\fB\%tgetnum\fP, +\fB\%tgetstr\fP, +\fB\%tgoto\fP, +\fB\%tputs\fP \- +\fIcurses\fR emulation of \fItermcap\fR .SH SYNOPSIS \fB#include \fP .br diff --git a/man/curs_terminfo.3x b/man/curs_terminfo.3x index 22ed0777..bd418951 100644 --- a/man/curs_terminfo.3x +++ b/man/curs_terminfo.3x @@ -28,8 +28,8 @@ .\" authorization. * .\"*************************************************************************** .\" -.\" $Id: curs_terminfo.3x,v 1.95 2023/08/19 20:37:54 tom Exp $ -.TH curs_terminfo 3X 2023-08-19 "ncurses 6.4" "Library calls" +.\" $Id: curs_terminfo.3x,v 1.99 2023/09/16 23:37:03 tom Exp $ +.TH curs_terminfo 3X 2023-09-16 "ncurses 6.4" "Library calls" .ie \n(.g .ds `` \(lq .el .ds `` `` .ie \n(.g .ds '' \(rq @@ -39,29 +39,26 @@ .el .IP \(bu 2 .. .ds n 5 -.na -.hy 0 .SH NAME -\fBdel_curterm\fP, -\fBmvcur\fP, -\fBputp\fP, -\fBrestartterm\fP, -\fBset_curterm\fP, -\fBsetupterm\fP, -\fBtigetflag\fP, -\fBtigetnum\fP, -\fBtigetstr\fP, -\fBtiparm\fP, -\fBtiparm_s\fP, -\fBtiscan_s\fP, -\fBtparm\fP, -\fBtputs\fP, -\fBvid_attr\fP, -\fBvid_puts\fP, -\fBvidattr\fP, -\fBvidputs\fP \- \fBcurses\fP interfaces to terminfo database -.ad -.hy +\fB\%del_curterm\fP, +\fB\%mvcur\fP, +\fB\%putp\fP, +\fB\%restartterm\fP, +\fB\%set_curterm\fP, +\fB\%setupterm\fP, +\fB\%tigetflag\fP, +\fB\%tigetnum\fP, +\fB\%tigetstr\fP, +\fB\%tiparm\fP, +\fB\%tiparm_s\fP, +\fB\%tiscan_s\fP, +\fB\%tparm\fP, +\fB\%tputs\fP, +\fB\%vid_attr\fP, +\fB\%vid_puts\fP, +\fB\%vidattr\fP, +\fB\%vidputs\fP \- +\fIcurses\fR interfaces to \fIterminfo\fR database .SH SYNOPSIS .nf \fB#include \fP diff --git a/man/curs_threads.3x b/man/curs_threads.3x index 153f348d..c058a14d 100644 --- a/man/curs_threads.3x +++ b/man/curs_threads.3x @@ -28,18 +28,15 @@ .\" authorization. * .\"*************************************************************************** .\" -.\" $Id: curs_threads.3x,v 1.37 2023/08/19 20:38:10 tom Exp $ -.TH curs_threads 3X 2023-08-19 "ncurses 6.4" "Library calls" +.\" $Id: curs_threads.3x,v 1.41 2023/09/16 23:37:03 tom Exp $ +.TH curs_threads 3X 2023-09-16 "ncurses 6.4" "Library calls" .de bP .ie n .IP \(bu 4 .el .IP \(bu 2 .. -.na -.hy 0 .SH NAME -\fBcurs_threads\fP \- \fBcurses\fP thread support -.ad -.hy +\fB\%curs_threads\fP \- +\fIcurses\fR thread support .SH SYNOPSIS \fB#include \fP .sp diff --git a/man/curs_touch.3x b/man/curs_touch.3x index e1faa612..46270aba 100644 --- a/man/curs_touch.3x +++ b/man/curs_touch.3x @@ -27,19 +27,16 @@ .\" authorization. * .\"*************************************************************************** .\" -.\" $Id: curs_touch.3x,v 1.30 2023/07/01 15:46:10 tom Exp $ -.TH curs_touch 3X 2023-07-01 "ncurses 6.4" "Library calls" -.na -.hy 0 +.\" $Id: curs_touch.3x,v 1.34 2023/09/16 23:37:03 tom Exp $ +.TH curs_touch 3X 2023-09-16 "ncurses 6.4" "Library calls" .SH NAME -\fBtouchwin\fP, -\fBtouchline\fP, -\fBuntouchwin\fP, -\fBwtouchln\fP, -\fBis_linetouched\fP, -\fBis_wintouched\fP \- \fBcurses\fP refresh control routines -.ad -.hy +\fB\%touchwin\fP, +\fB\%touchline\fP, +\fB\%untouchwin\fP, +\fB\%wtouchln\fP, +\fB\%is_linetouched\fP, +\fB\%is_wintouched\fP \- +control terminal output refresh in a \fIcurses\fR window .SH SYNOPSIS \fB#include \fP .sp diff --git a/man/curs_trace.3x b/man/curs_trace.3x index 5117d3de..add2b6be 100644 --- a/man/curs_trace.3x +++ b/man/curs_trace.3x @@ -27,7 +27,8 @@ .\" authorization. * .\"*************************************************************************** .\" -.\" $Id: curs_trace.3x,v 1.29 2023/07/01 15:46:10 tom Exp $ +.\" $Id: curs_trace.3x,v 1.35 2023/09/16 23:37:03 tom Exp $ +.TH curs_trace 3X 2023-09-16 "ncurses 6.4" "Library calls" .ie \n(.g .ds `` \(lq .el .ds `` `` .ie \n(.g .ds '' \(rq @@ -36,25 +37,21 @@ .ie n .IP \(bu 4 .el .IP \(bu 2 .. -.TH curs_trace 3X 2023-07-01 "ncurses 6.4" "Library calls" -.na -.hy 0 .SH NAME -\fBcurses_trace\fP, -\fBtrace\fP, -\fB_tracef\fP, -\fB_traceattr\fP, -\fB_traceattr2\fP, -\fB_tracecchar_t\fP, -\fB_tracecchar_t2\fP, -\fB_tracechar\fP, -\fB_tracechtype\fP, -\fB_tracechtype2\fP, -\fB_nc_tracebits\fP, -\fB_tracedump\fP, -\fB_tracemouse\fP \- \fBcurses\fP debugging routines -.ad -.hy +\fB\%curses_trace\fP, +\fB\%trace\fP, +\fB\%_tracef\fP, +\fB\%_traceattr\fP, +\fB\%_traceattr2\fP, +\fB\%_tracecchar_t\fP, +\fB\%_tracecchar_t2\fP, +\fB\%_tracechar\fP, +\fB\%_tracechtype\fP, +\fB\%_tracechtype2\fP, +\fB\%_nc_tracebits\fP, +\fB\%_tracedump\fP, +\fB\%_tracemouse\fP \- +\fIcurses\fR debugging routines .SH SYNOPSIS \fB#include \fP .sp @@ -199,8 +196,6 @@ These functions check the \fBNCURSES_TRACE\fP environment variable, to set the tracing feature as if \fBcurses_trace\fP was called: .RS 4 .PP -.na -.hy 0 filter, initscr, new_prescr, @@ -214,8 +209,6 @@ tgetent, use_env, use_extended_names, use_tioctl -.hy -.ad .RE .SS Command-line Utilities The command-line utilities such as \fBtic\fP(1) provide a verbose option diff --git a/man/curs_util.3x b/man/curs_util.3x index 4f741350..6390749b 100644 --- a/man/curs_util.3x +++ b/man/curs_util.3x @@ -28,8 +28,8 @@ .\" authorization. * .\"*************************************************************************** .\" -.\" $Id: curs_util.3x,v 1.73 2023/08/19 20:38:17 tom Exp $ -.TH curs_util 3X 2023-08-19 "ncurses 6.4" "Library calls" +.\" $Id: curs_util.3x,v 1.77 2023/09/16 23:37:03 tom Exp $ +.TH curs_util 3X 2023-09-16 "ncurses 6.4" "Library calls" .ie \n(.g .ds `` \(lq .el .ds `` `` .ie \n(.g .ds '' \(rq @@ -38,23 +38,20 @@ .ie n .IP \(bu 4 .el .IP \(bu 2 .. -.na -.hy 0 .SH NAME -\fBdelay_output\fP, -\fBfilter\fP, -\fBflushinp\fP, -\fBgetwin\fP, -\fBkey_name\fP, -\fBkeyname\fP, -\fBnofilter\fP, -\fBputwin\fP, -\fBunctrl\fP, -\fBuse_env\fP, -\fBuse_tioctl\fP, -\fBwunctrl\fP \- miscellaneous \fBcurses\fP utility routines -.ad -.hy +\fB\%delay_output\fP, +\fB\%filter\fP, +\fB\%flushinp\fP, +\fB\%getwin\fP, +\fB\%key_name\fP, +\fB\%keyname\fP, +\fB\%nofilter\fP, +\fB\%putwin\fP, +\fB\%unctrl\fP, +\fB\%use_env\fP, +\fB\%use_tioctl\fP, +\fB\%wunctrl\fP \- +miscellaneous \fIcurses\fR utility routines .SH SYNOPSIS \fB#include \fP .sp diff --git a/man/curs_variables.3x b/man/curs_variables.3x index 4d5b684a..62dccd09 100644 --- a/man/curs_variables.3x +++ b/man/curs_variables.3x @@ -1,5 +1,5 @@ .\"*************************************************************************** -.\" Copyright 2018-2020,2021 Thomas E. Dickey * +.\" Copyright 2018-2021,2023 Thomas E. Dickey * .\" Copyright 2010-2015,2017 Free Software Foundation, Inc. * .\" * .\" Permission is hereby granted, free of charge, to any person obtaining a * @@ -27,8 +27,8 @@ .\" authorization. * .\"*************************************************************************** .\" -.\" $Id: curs_variables.3x,v 1.18 2021/12/25 21:49:32 tom Exp $ -.TH curs_variables 3X 2021-12-25 "ncurses 6.4" "Library calls" +.\" $Id: curs_variables.3x,v 1.23 2023/09/16 23:37:03 tom Exp $ +.TH curs_variables 3X 2023-09-16 "ncurses 6.4" "Library calls" .ie \n(.g .ds `` \(lq .el .ds `` `` .ie \n(.g .ds '' \(rq @@ -38,21 +38,17 @@ .el .IP \(bu 2 .. .ds n 5 -.na -.hy 0 .SH NAME -\fBCOLORS\fP, -\fBCOLOR_PAIRS\fP, -\fBCOLS\fP, -\fBESCDELAY\fP, -\fBLINES\fP, -\fBTABSIZE\fP, -\fBcurscr\fP, -\fBnewscr\fP, -\fBstdscr\fP -\- \fBcurses\fP global variables -.ad -.hy +\fB\%COLORS\fP, +\fB\%COLOR_PAIRS\fP, +\fB\%COLS\fP, +\fB\%ESCDELAY\fP, +\fB\%LINES\fP, +\fB\%TABSIZE\fP, +\fB\%curscr\fP, +\fB\%newscr\fP, +\fB\%stdscr\fP \- +\fIcurses\fR global variables .SH SYNOPSIS .nf \fB#include \fP diff --git a/man/curs_window.3x b/man/curs_window.3x index 8215a066..931372db 100644 --- a/man/curs_window.3x +++ b/man/curs_window.3x @@ -27,28 +27,25 @@ .\" authorization. * .\"*************************************************************************** .\" -.\" $Id: curs_window.3x,v 1.32 2023/07/01 15:46:10 tom Exp $ -.TH curs_window 3X 2023-07-01 "ncurses 6.4" "Library calls" +.\" $Id: curs_window.3x,v 1.36 2023/09/16 23:37:03 tom Exp $ +.TH curs_window 3X 2023-09-16 "ncurses 6.4" "Library calls" .de bP .ie n .IP \(bu 4 .el .IP \(bu 2 .. -.na -.hy 0 .SH NAME -\fBnewwin\fP, -\fBdelwin\fP, -\fBmvwin\fP, -\fBsubwin\fP, -\fBderwin\fP, -\fBmvderwin\fP, -\fBdupwin\fP, -\fBwsyncup\fP, -\fBsyncok\fP, -\fBwcursyncup\fP, -\fBwsyncdown\fP \- create \fBcurses\fP windows -.ad -.hy +\fB\%newwin\fP, +\fB\%delwin\fP, +\fB\%mvwin\fP, +\fB\%subwin\fP, +\fB\%derwin\fP, +\fB\%mvderwin\fP, +\fB\%dupwin\fP, +\fB\%wsyncup\fP, +\fB\%syncok\fP, +\fB\%wcursyncup\fP, +\fB\%wsyncdown\fP \- +create and manipulate \fIcurses\fR windows .SH SYNOPSIS \fB#include \fP .sp diff --git a/man/default_colors.3x b/man/default_colors.3x index f60740e4..8ffb6ed4 100644 --- a/man/default_colors.3x +++ b/man/default_colors.3x @@ -29,15 +29,16 @@ .\" .\" Author: Thomas E. Dickey 1997,1999,2000,2005 .\" -.\" $Id: default_colors.3x,v 1.38 2023/08/19 19:48:15 tom Exp $ -.TH default_colors 3X 2023-08-19 "ncurses 6.4" "Library calls" +.\" $Id: default_colors.3x,v 1.41 2023/09/16 23:37:03 tom Exp $ +.TH default_colors 3X 2023-09-16 "ncurses 6.4" "Library calls" .ie \n(.g .ds `` \(lq .el .ds `` `` .ie \n(.g .ds '' \(rq .el .ds '' '' .SH NAME -\fBuse_default_colors\fP, -\fBassume_default_colors\fP \- use terminal's default colors +\fB\%use_default_colors\fP, +\fB\%assume_default_colors\fP \- +use terminal's default colors .SH SYNOPSIS \fB#include \fP .sp diff --git a/man/define_key.3x b/man/define_key.3x index f2962d8b..d4ac62f4 100644 --- a/man/define_key.3x +++ b/man/define_key.3x @@ -1,5 +1,5 @@ .\"*************************************************************************** -.\" Copyright 2018-2021,2022 Thomas E. Dickey * +.\" Copyright 2018-2022,2023 Thomas E. Dickey * .\" Copyright 1998-2010,2017 Free Software Foundation, Inc. * .\" * .\" Permission is hereby granted, free of charge, to any person obtaining a * @@ -29,10 +29,11 @@ .\" .\" Author: Thomas E. Dickey 1997 .\" -.\" $Id: define_key.3x,v 1.22 2022/02/12 20:03:40 tom Exp $ -.TH define_key 3X 2022-02-12 "ncurses 6.4" "Library calls" +.\" $Id: define_key.3x,v 1.27 2023/09/16 23:37:03 tom Exp $ +.TH define_key 3X 2023-09-16 "ncurses 6.4" "Library calls" .SH NAME -\fBdefine_key\fP \- define a keycode +\fB\%define_key\fP \- +define a \fIcurses\fR keycode .SH SYNOPSIS \fB#include \fP .sp diff --git a/man/form.3x b/man/form.3x index ff81a43d..b91314b2 100644 --- a/man/form.3x +++ b/man/form.3x @@ -28,8 +28,8 @@ .\" authorization. * .\"*************************************************************************** .\" -.\" $Id: form.3x,v 1.43 2023/08/19 20:38:32 tom Exp $ -.TH form 3X 2023-08-19 "ncurses 6.4" "Library calls" +.\" $Id: form.3x,v 1.45 2023/09/16 23:37:03 tom Exp $ +.TH form 3X 2023-09-16 "ncurses 6.4" "Library calls" .ie \n(.g .ds `` \(lq .el .ds `` `` .ie \n(.g .ds '' \(rq @@ -39,7 +39,8 @@ .el .IP \(bu 2 .. .SH NAME -\fBform\fP \- curses extension for programming forms +\fBform\fP \- +curses extension for programming forms .SH SYNOPSIS \fB#include \fP .SH DESCRIPTION diff --git a/man/form_cursor.3x b/man/form_cursor.3x index 338fc902..e984bd5e 100644 --- a/man/form_cursor.3x +++ b/man/form_cursor.3x @@ -28,10 +28,11 @@ .\" authorization. * .\"*************************************************************************** .\" -.\" $Id: form_cursor.3x,v 1.21 2023/07/01 15:46:10 tom Exp $ -.TH form_cursor 3X 2023-07-01 "ncurses 6.4" "Library calls" +.\" $Id: form_cursor.3x,v 1.23 2023/09/16 23:37:03 tom Exp $ +.TH form_cursor 3X 2023-09-16 "ncurses 6.4" "Library calls" .SH NAME -\fBpos_form_cursor\fP \- position a form window cursor +\fBpos_form_cursor\fP \- +position a form window cursor .SH SYNOPSIS \fB#include \fP .sp diff --git a/man/form_data.3x b/man/form_data.3x index ce428754..fdc18d6d 100644 --- a/man/form_data.3x +++ b/man/form_data.3x @@ -28,11 +28,12 @@ .\" authorization. * .\"*************************************************************************** .\" -.\" $Id: form_data.3x,v 1.22 2023/07/01 15:46:10 tom Exp $ -.TH form_data 3X 2023-07-01 "ncurses 6.4" "Library calls" +.\" $Id: form_data.3x,v 1.24 2023/09/16 23:37:03 tom Exp $ +.TH form_data 3X 2023-09-16 "ncurses 6.4" "Library calls" .SH NAME \fBdata_ahead\fP, -\fBdata_behind\fP \- test for off-screen data in given forms +\fBdata_behind\fP \- +test for off-screen data in given forms .SH SYNOPSIS \fB#include \fP .sp diff --git a/man/form_driver.3x b/man/form_driver.3x index 9824f986..ff079dea 100644 --- a/man/form_driver.3x +++ b/man/form_driver.3x @@ -28,15 +28,16 @@ .\" authorization. * .\"*************************************************************************** .\" -.\" $Id: form_driver.3x,v 1.45 2023/08/19 20:38:39 tom Exp $ -.TH form_driver 3X 2023-08-19 "ncurses 6.4" "Library calls" +.\" $Id: form_driver.3x,v 1.47 2023/09/16 23:37:03 tom Exp $ +.TH form_driver 3X 2023-09-16 "ncurses 6.4" "Library calls" .de bP .ie n .IP \(bu 4 .el .IP \(bu 2 .. .SH NAME \fBform_driver\fP, -\fBform_driver_w\fP \- command-processing loop of the form system +\fBform_driver_w\fP \- +command-processing loop of the form system .SH SYNOPSIS \fB#include \fP .sp diff --git a/man/form_field.3x b/man/form_field.3x index 3161de5b..92e30045 100644 --- a/man/form_field.3x +++ b/man/form_field.3x @@ -28,10 +28,11 @@ .\" authorization. * .\"*************************************************************************** .\" -.\" $Id: form_field.3x,v 1.24 2023/07/01 15:46:10 tom Exp $ -.TH form_field 3X 2023-07-01 "ncurses 6.4" "Library calls" +.\" $Id: form_field.3x,v 1.26 2023/09/16 23:37:03 tom Exp $ +.TH form_field 3X 2023-09-16 "ncurses 6.4" "Library calls" .SH NAME -\fBform_field\fP \- make and break connections between fields and forms +\fBform_field\fP \- +make and break connections between fields and forms .SH SYNOPSIS \fB#include \fP .sp diff --git a/man/form_field_attributes.3x b/man/form_field_attributes.3x index 6cae1f37..fa3f7f1c 100644 --- a/man/form_field_attributes.3x +++ b/man/form_field_attributes.3x @@ -28,14 +28,15 @@ .\" authorization. * .\"*************************************************************************** .\" -.\" $Id: form_field_attributes.3x,v 1.25 2023/07/01 15:46:10 tom Exp $ -.TH form_field_attributes 3X 2023-07-01 "ncurses 6.4" "Library calls" +.\" $Id: form_field_attributes.3x,v 1.27 2023/09/16 23:37:03 tom Exp $ +.TH form_field_attributes 3X 2023-09-16 "ncurses 6.4" "Library calls" .ie \n(.g .ds `` \(lq .el .ds `` `` .ie \n(.g .ds '' \(rq .el .ds '' '' .SH NAME -\fBform_field_attributes\fP \- color and attribute control for form fields +\fBform_field_attributes\fP \- +color and attribute control for form fields .SH SYNOPSIS \fB#include \fP .sp diff --git a/man/form_field_buffer.3x b/man/form_field_buffer.3x index 8a484a1c..5e85c3fd 100644 --- a/man/form_field_buffer.3x +++ b/man/form_field_buffer.3x @@ -28,8 +28,8 @@ .\" authorization. * .\"*************************************************************************** .\" -.\" $Id: form_field_buffer.3x,v 1.34 2023/07/01 15:46:10 tom Exp $ -.TH form_field_buffer 3X 2023-07-01 "ncurses 6.4" "Library calls" +.\" $Id: form_field_buffer.3x,v 1.36 2023/09/16 23:37:03 tom Exp $ +.TH form_field_buffer 3X 2023-09-16 "ncurses 6.4" "Library calls" .ie \n(.g .ds `` \(lq .el .ds `` `` .ie \n(.g .ds '' \(rq @@ -39,7 +39,8 @@ .el .IP \(bu 2 .. .SH NAME -\fBform_field_buffer\fP \- field buffer control +\fBform_field_buffer\fP \- +field buffer control .SH SYNOPSIS \fB#include \fP .sp diff --git a/man/form_field_info.3x b/man/form_field_info.3x index 2c18bc78..3465ddae 100644 --- a/man/form_field_info.3x +++ b/man/form_field_info.3x @@ -1,6 +1,6 @@ '\" t .\"*************************************************************************** -.\" Copyright 2018-2021,2022 Thomas E. Dickey * +.\" Copyright 2018-2022,2023 Thomas E. Dickey * .\" Copyright 1998-2010,2015 Free Software Foundation, Inc. * .\" * .\" Permission is hereby granted, free of charge, to any person obtaining a * @@ -28,15 +28,16 @@ .\" authorization. * .\"*************************************************************************** .\" -.\" $Id: form_field_info.3x,v 1.22 2022/02/12 20:03:40 tom Exp $ -.TH form_field_info 3X 2022-02-12 "ncurses 6.4" "Library calls" +.\" $Id: form_field_info.3x,v 1.24 2023/09/16 23:39:54 tom Exp $ +.TH form_field_info 3X 2023-09-16 "ncurses 6.4" "Library calls" .ie \n(.g .ds `` \(lq .el .ds `` `` .ie \n(.g .ds '' \(rq .el .ds '' '' .SH NAME \fBdynamic_field_info\fP, -\fBfield_info\fP \- retrieve field characteristics +\fBfield_info\fP \- +retrieve field characteristics .SH SYNOPSIS .nf \fB#include \fP diff --git a/man/form_field_just.3x b/man/form_field_just.3x index 6cd1f327..fc9cb4bb 100644 --- a/man/form_field_just.3x +++ b/man/form_field_just.3x @@ -28,15 +28,16 @@ .\" authorization. * .\"*************************************************************************** .\" -.\" $Id: form_field_just.3x,v 1.25 2023/07/01 15:46:10 tom Exp $ -.TH form_field_just 3X 2023-07-01 "ncurses 6.4" "Library calls" +.\" $Id: form_field_just.3x,v 1.27 2023/09/16 23:37:03 tom Exp $ +.TH form_field_just 3X 2023-09-16 "ncurses 6.4" "Library calls" .ie \n(.g .ds `` \(lq .el .ds `` `` .ie \n(.g .ds '' \(rq .el .ds '' '' .SH NAME \fBset_field_just\fP, -\fBfield_just\fP \- retrieve field characteristics +\fBfield_just\fP \- +retrieve field characteristics .SH SYNOPSIS \fB#include \fP .sp diff --git a/man/form_field_new.3x b/man/form_field_new.3x index 4c9efcab..f8dfb98a 100644 --- a/man/form_field_new.3x +++ b/man/form_field_new.3x @@ -28,13 +28,14 @@ .\" authorization. * .\"*************************************************************************** .\" -.\" $Id: form_field_new.3x,v 1.31 2023/07/01 15:46:10 tom Exp $ -.TH form_field_new 3X 2023-07-01 "ncurses 6.4" "Library calls" +.\" $Id: form_field_new.3x,v 1.33 2023/09/16 23:37:03 tom Exp $ +.TH form_field_new 3X 2023-09-16 "ncurses 6.4" "Library calls" .SH NAME \fBnew_field\fP, \fBdup_field\fP, \fBlink_field\fP, -\fBfree_field\fP \- create and destroy form fields +\fBfree_field\fP \- +create and destroy form fields .SH SYNOPSIS \fB#include \fP .sp diff --git a/man/form_field_opts.3x b/man/form_field_opts.3x index 3edac10d..2649cc42 100644 --- a/man/form_field_opts.3x +++ b/man/form_field_opts.3x @@ -28,13 +28,14 @@ .\" authorization. * .\"*************************************************************************** .\" -.\" $Id: form_field_opts.3x,v 1.34 2023/07/01 15:46:10 tom Exp $ -.TH form_field_opts 3X 2023-07-01 "ncurses 6.4" "Library calls" +.\" $Id: form_field_opts.3x,v 1.36 2023/09/16 23:37:03 tom Exp $ +.TH form_field_opts 3X 2023-09-16 "ncurses 6.4" "Library calls" .SH NAME \fBset_field_opts\fP, \fBfield_opts_on\fP, \fBfield_opts_off\fP, -\fBfield_opts\fP \- set and get field options +\fBfield_opts\fP \- +set and get field options .SH SYNOPSIS \fB#include \fP .sp diff --git a/man/form_field_userptr.3x b/man/form_field_userptr.3x index 4c760673..e01edf01 100644 --- a/man/form_field_userptr.3x +++ b/man/form_field_userptr.3x @@ -1,6 +1,6 @@ '\" t .\"*************************************************************************** -.\" Copyright 2018-2021,2022 Thomas E. Dickey * +.\" Copyright 2018-2022,2023 Thomas E. Dickey * .\" Copyright 1998-2010,2015 Free Software Foundation, Inc. * .\" * .\" Permission is hereby granted, free of charge, to any person obtaining a * @@ -28,11 +28,12 @@ .\" authorization. * .\"*************************************************************************** .\" -.\" $Id: form_field_userptr.3x,v 1.20 2022/02/12 20:03:40 tom Exp $ -.TH form_field_userptr 3X 2022-02-12 "ncurses 6.4" "Library calls" +.\" $Id: form_field_userptr.3x,v 1.22 2023/09/16 23:39:54 tom Exp $ +.TH form_field_userptr 3X 2023-09-16 "ncurses 6.4" "Library calls" .SH NAME \fBset_field_userptr\fP, -\fBfield_userptr\fP \- associate application data with a form field +\fBfield_userptr\fP \- +associate application data with a form field .SH SYNOPSIS \fB#include \fP .sp diff --git a/man/form_field_validation.3x b/man/form_field_validation.3x index f46abec9..93cfd858 100644 --- a/man/form_field_validation.3x +++ b/man/form_field_validation.3x @@ -27,8 +27,8 @@ .\" authorization. * .\"*************************************************************************** .\" -.\" $Id: form_field_validation.3x,v 1.40 2023/07/01 15:46:10 tom Exp $ -.TH form_field_validation 3X 2023-07-01 "ncurses 6.4" "Library calls" +.\" $Id: form_field_validation.3x,v 1.44 2023/09/16 23:37:03 tom Exp $ +.TH form_field_validation 3X 2023-09-16 "ncurses 6.4" "Library calls" .ie \n(.g .ds `` \(lq .el .ds `` `` .ie \n(.g .ds '' \(rq @@ -38,7 +38,8 @@ .el .IP \(bu 2 .. .SH NAME -\fBform_field_validation\fP \- data type validation for fields +\fBform_field_validation\fP \- +data type validation for fields .SH SYNOPSIS \fB#include \fP .sp @@ -82,7 +83,7 @@ Most field types are configurable, via arguments which the caller provides when calling \fBset_field_type\fP. .PP Several field types are predefined by the form library. -.SS Predefined types +.SH PREDEFINED TYPES It is possible to set up new programmer-defined field types. Field types are implemented via the \fBFIELDTYPE\fP data structure, which contains several pointers to functions. @@ -92,27 +93,19 @@ which describes functions which can be used to construct a field-type dynamically. .PP The predefined types are as follows: -.TP 5 -TYPE_ALNUM +.SS TYPE_ALNUM Alphanumeric data. Required parameter: -.RS .bP a third \fBint\fP argument, a minimum field width. -.RE -.TP 5 -TYPE_ALPHA +.SS TYPE_ALPHA Character data. Required parameter: -.RS .bP a third \fBint\fP argument, a minimum field width. -.RE -.TP 5 -TYPE_ENUM +.SS TYPE_ENUM Accept one of a specified set of strings. Required parameters: -.RS .bP a third \fB(char **)\fP argument pointing to a string list; .bP @@ -122,15 +115,12 @@ a fifth \fBint\fP flag argument specifying whether a partial match must be a unique one. If this flag is off, a prefix matches the first of any set of more than one list elements with that prefix. -.RE -.IP +.PP The library copies the string list, so you may use a list that lives in automatic variables on the stack. -.TP 5 -TYPE_INTEGER +.SS TYPE_INTEGER Integer data, parsable to an integer by \fBatoi\fP(3). Required parameters: -.RS .bP a third \fBint\fP argument controlling the precision, .bP @@ -139,18 +129,15 @@ a fourth \fBlong\fP argument constraining minimum value, a fifth \fBlong\fP constraining maximum value. If the maximum value is less than or equal to the minimum value, the range is simply ignored. -.RE -.IP +.PP On return, the field buffer is formatted according to the \fBprintf\fP format specification \*(``.*ld\*('', where the \*(``*\*('' is replaced by the precision argument. -.IP +.PP For details of the precision handling see \fBprintf\fP(3). -.TP 5 -TYPE_NUMERIC +.SS TYPE_NUMERIC Numeric data (may have a decimal-point part). Required parameters: -.RS .bP a third \fBint\fP argument controlling the precision, .bP @@ -161,26 +148,22 @@ If your system supports locales, the decimal point character must be the one specified by your locale. If the maximum value is less than or equal to the minimum value, the range is simply ignored. -.RE -.IP +.PP On return, the field buffer is formatted according to the \fBprintf\fP format specification \*(``.*f\*('', where the \*(``*\*('' is replaced by the precision argument. -.IP +.PP For details of the precision handling see \fBprintf\fP(3). -.TP 5 -TYPE_REGEXP +.SS TYPE_REGEXP Regular expression data. Required parameter: -.RS .bP a third argument, a regular expression \fB(char *)\fP string. The data is valid if the regular expression matches it. -.RE -.IP +.PP Regular expressions are in the format of \fBregcomp\fP and \fBregexec\fP. -.IP +.PP The regular expression must match the whole field. If you have for example, an eight character wide field, a regular expression "^[0\-9]*$" always @@ -190,20 +173,17 @@ you may use for example "^[0\-9]* *$" which is good for trailing spaces (up to an empty field), or "^ *[0\-9]* *$" which is good for leading and trailing spaces around the digits. -.TP 5 -TYPE_IPV4 +.SS TYPE_IPV4 An Internet Protocol Version 4 address. Required parameter: -.RS .bP none -.RE -.IP +.PP The form library checks whether or not the buffer has the form \fIa.b.c.d\fP, where \fIa\fP, \fIb\fP, \fIc\fP, and \fId\fP are numbers in the range 0 to 255. Trailing blanks in the buffer are ignored. The address itself is not validated. -.IP +.PP This is an ncurses extension; this field type may not be available in other curses implementations. .SH RETURN VALUE diff --git a/man/form_fieldtype.3x b/man/form_fieldtype.3x index 730ebc91..4063baf0 100644 --- a/man/form_fieldtype.3x +++ b/man/form_fieldtype.3x @@ -28,14 +28,15 @@ .\" authorization. * .\"*************************************************************************** .\" -.\" $Id: form_fieldtype.3x,v 1.35 2023/07/01 15:46:10 tom Exp $ +.\" $Id: form_fieldtype.3x,v 1.38 2023/09/16 23:37:03 tom Exp $ +.TH form_fieldtype 3X 2023-09-16 "ncurses 6.4" "Library calls" .de bP .ie n .IP \(bu 4 .el .IP \(bu 2 .. -.TH form_fieldtype 3X 2023-07-01 "ncurses 6.4" "Library calls" .SH NAME -\fBform_fieldtype\fP \- define validation-field types +\fBform_fieldtype\fP \- +define validation-field types .SH SYNOPSIS \fB#include \fP .sp diff --git a/man/form_hook.3x b/man/form_hook.3x index 010d48e1..54a0f632 100644 --- a/man/form_hook.3x +++ b/man/form_hook.3x @@ -28,10 +28,11 @@ .\" authorization. * .\"*************************************************************************** .\" -.\" $Id: form_hook.3x,v 1.23 2023/07/01 15:46:10 tom Exp $ -.TH form_hook 3X 2023-07-01 "ncurses 6.4" "Library calls" +.\" $Id: form_hook.3x,v 1.25 2023/09/16 23:37:03 tom Exp $ +.TH form_hook 3X 2023-09-16 "ncurses 6.4" "Library calls" .SH NAME -\fBform_hook\fP \- set hooks for automatic invocation by applications +\fBform_hook\fP \- +set hooks for automatic invocation by applications .SH SYNOPSIS \fB#include \fP .sp @@ -53,27 +54,28 @@ .SH DESCRIPTION These functions make it possible to set hook functions to be called at various points in the automatic processing of input event codes by \fBform_driver\fP. -.PP -The function \fBset_field_init\fP sets a hook to be called at form-post time +.SS set_field_init\fP +sets a hook to be called at form-post time and each time the selected field changes (after the change). -\fBfield_init\fP +.SS field_init returns the current field init hook, if any (\fBNULL\fP if there is no such hook). -.PP -The function \fBset_field_term\fP sets a hook to be called at form-unpost time +.SS set_field_term +sets a hook to be called at form-unpost time and each time the selected field changes (before the change). -\fBfield_term\fP +.SS field_term returns the current field term hook, if any (\fBNULL\fP if there is no such hook). -.PP -The function \fBset_form_init\fP sets a hook to be called at form-post time and +.SS set_form_init +sets a hook to be called at form-post time and just after a page change once it is posted. -\fBform_init\fP returns the -current form init hook, if any (\fBNULL\fP if there is no such hook). -.PP -The function \fBset_form_term\fP sets a hook to be called at form-unpost time +.SS form_init +returns the current form init hook, +if any (\fBNULL\fP if there is no such hook). +.SS set_form_term +sets a hook to be called at form-unpost time and just before a page change once it is posted. -\fBform_init\fP +.SS form_init returns the current form term hook, if any (\fBNULL\fP if there is no such hook). .SH RETURN VALUE diff --git a/man/form_new.3x b/man/form_new.3x index fae1f0b0..b2a992c3 100644 --- a/man/form_new.3x +++ b/man/form_new.3x @@ -28,11 +28,12 @@ .\" authorization. * .\"*************************************************************************** .\" -.\" $Id: form_new.3x,v 1.22 2023/07/01 15:46:10 tom Exp $ -.TH form_new 3X 2023-07-01 "ncurses 6.4" "Library calls" +.\" $Id: form_new.3x,v 1.24 2023/09/16 23:37:03 tom Exp $ +.TH form_new 3X 2023-09-16 "ncurses 6.4" "Library calls" .SH NAME \fBnew_form\fP, -\fBfree_form\fP \- create and destroy forms +\fBfree_form\fP \- +create and destroy forms .SH SYNOPSIS \fB#include \fP .sp diff --git a/man/form_new_page.3x b/man/form_new_page.3x index 7f41c2f9..3b93b1e0 100644 --- a/man/form_new_page.3x +++ b/man/form_new_page.3x @@ -28,15 +28,16 @@ .\" authorization. * .\"*************************************************************************** .\" -.\" $Id: form_new_page.3x,v 1.24 2023/07/01 15:46:10 tom Exp $ -.TH form_new_page 3X 2023-07-01 "ncurses 6.4" "Library calls" +.\" $Id: form_new_page.3x,v 1.26 2023/09/16 23:37:03 tom Exp $ +.TH form_new_page 3X 2023-09-16 "ncurses 6.4" "Library calls" .ie \n(.g .ds `` \(lq .el .ds `` `` .ie \n(.g .ds '' \(rq .el .ds '' '' .SH NAME \fBset_new_page\fP, -\fBnew_page\fP \- form pagination functions +\fBnew_page\fP \- +form pagination functions .SH SYNOPSIS \fB#include \fP .sp diff --git a/man/form_opts.3x b/man/form_opts.3x index f108605a..eb72f862 100644 --- a/man/form_opts.3x +++ b/man/form_opts.3x @@ -28,13 +28,14 @@ .\" authorization. * .\"*************************************************************************** .\" -.\" $Id: form_opts.3x,v 1.24 2023/07/01 15:46:10 tom Exp $ -.TH form_opts 3X 2023-07-01 "ncurses 6.4" "Library calls" +.\" $Id: form_opts.3x,v 1.26 2023/09/16 23:37:03 tom Exp $ +.TH form_opts 3X 2023-09-16 "ncurses 6.4" "Library calls" .SH NAME \fBset_form_opts\fP, \fBform_opts_on\fP, \fBform_opts_off\fP, -\fBform_opts\fP \- set and get form options +\fBform_opts\fP \- +set and get form options .SH SYNOPSIS \fB#include \fP .sp diff --git a/man/form_page.3x b/man/form_page.3x index 36d0b1d8..5a9c1835 100644 --- a/man/form_page.3x +++ b/man/form_page.3x @@ -28,10 +28,11 @@ .\" authorization. * .\"*************************************************************************** .\" -.\" $Id: form_page.3x,v 1.26 2023/07/01 15:46:10 tom Exp $ -.TH form_page 3X 2023-07-01 "ncurses 6.4" "Library calls" +.\" $Id: form_page.3x,v 1.28 2023/09/16 23:37:03 tom Exp $ +.TH form_page 3X 2023-09-16 "ncurses 6.4" "Library calls" .SH NAME -\fBform_page\fP \- set and get form page number +\fBform_page\fP \- +set and get form page number .SH SYNOPSIS \fB#include \fP .sp diff --git a/man/form_post.3x b/man/form_post.3x index e7e6733f..471b88d4 100644 --- a/man/form_post.3x +++ b/man/form_post.3x @@ -28,11 +28,12 @@ .\" authorization. * .\"*************************************************************************** .\" -.\" $Id: form_post.3x,v 1.23 2023/07/01 15:46:10 tom Exp $ -.TH form_post 3X 2023-07-01 "ncurses 6.4" "Library calls" +.\" $Id: form_post.3x,v 1.25 2023/09/16 23:37:03 tom Exp $ +.TH form_post 3X 2023-09-16 "ncurses 6.4" "Library calls" .SH NAME \fBpost_form\fP, -\fBunpost_form\fP \- write or erase forms from associated subwindows +\fBunpost_form\fP \- +write or erase forms from associated subwindows .SH SYNOPSIS \fB#include \fP .sp diff --git a/man/form_requestname.3x b/man/form_requestname.3x index df224502..dbd97309 100644 --- a/man/form_requestname.3x +++ b/man/form_requestname.3x @@ -28,11 +28,12 @@ .\" authorization. * .\"*************************************************************************** .\" -.\" $Id: form_requestname.3x,v 1.23 2023/07/01 15:46:10 tom Exp $ -.TH form_requestname 3X 2023-07-01 "ncurses 6.4" "Library calls" +.\" $Id: form_requestname.3x,v 1.26 2023/09/16 23:37:03 tom Exp $ +.TH form_requestname 3X 2023-09-16 "ncurses 6.4" "Library calls" .SH NAME \fBform_request_by_name\fP, -\fBform_request_name\fP \- handle printable form request names +\fBform_request_name\fP \- +handle printable form request names .SH SYNOPSIS \fB#include \fP .sp @@ -40,10 +41,8 @@ .br \fBint form_request_by_name(const char *\fIname\fB);\fR .SH DESCRIPTION -.SS form_request_name The function \fBform_request_name\fP returns the printable name of a form request code. -.SS form_request_name_by_name The function \fBform_request_by_name\fP searches in the name-table for a request with the given name and returns its request code. Otherwise E_NO_MATCH is returned. diff --git a/man/form_userptr.3x b/man/form_userptr.3x index d424dc58..e7d9216f 100644 --- a/man/form_userptr.3x +++ b/man/form_userptr.3x @@ -28,11 +28,12 @@ .\" authorization. * .\"*************************************************************************** .\" -.\" $Id: form_userptr.3x,v 1.26 2023/07/01 15:46:10 tom Exp $ -.TH form_userptr 3X 2023-07-01 "ncurses 6.4" "Library calls" +.\" $Id: form_userptr.3x,v 1.28 2023/09/16 23:37:03 tom Exp $ +.TH form_userptr 3X 2023-09-16 "ncurses 6.4" "Library calls" .SH NAME \fBset_form_userptr\fP, -\fBform_userptr\fP \- associate application data with a form item +\fBform_userptr\fP \- +associate application data with a form item .SH SYNOPSIS \fB#include \fP .sp diff --git a/man/form_variables.3x b/man/form_variables.3x index 1f97fef4..54a1d65f 100644 --- a/man/form_variables.3x +++ b/man/form_variables.3x @@ -1,5 +1,5 @@ .\"*************************************************************************** -.\" Copyright 2020,2021 Thomas E. Dickey * +.\" Copyright 2020-2021,2023 Thomas E. Dickey * .\" Copyright 2010-2013,2017 Free Software Foundation, Inc. * .\" * .\" Permission is hereby granted, free of charge, to any person obtaining a * @@ -27,8 +27,8 @@ .\" authorization. * .\"*************************************************************************** .\" -.\" $Id: form_variables.3x,v 1.10 2021/12/25 21:50:36 tom Exp $ -.TH form_variables 3X 2021-12-25 "ncurses 6.4" "Library calls" +.\" $Id: form_variables.3x,v 1.12 2023/09/16 23:39:54 tom Exp $ +.TH form_variables 3X 2023-09-16 "ncurses 6.4" "Library calls" .na .hy 0 .SH NAME @@ -38,8 +38,8 @@ \fBTYPE_INTEGER\fP, \fBTYPE_IPV4\fP, \fBTYPE_NUMERIC\fP, -\fBTYPE_REGEXP\fP -\- form system global variables +\fBTYPE_REGEXP\fP \- +form system global variables .ad .hy .SH SYNOPSIS diff --git a/man/form_win.3x b/man/form_win.3x index ba9e3687..c7cf800a 100644 --- a/man/form_win.3x +++ b/man/form_win.3x @@ -28,10 +28,11 @@ .\" authorization. * .\"*************************************************************************** .\" -.\" $Id: form_win.3x,v 1.25 2023/07/01 15:46:10 tom Exp $ -.TH form_win 3X 2023-07-01 "ncurses 6.4" "Library calls" +.\" $Id: form_win.3x,v 1.27 2023/09/16 23:37:03 tom Exp $ +.TH form_win 3X 2023-09-16 "ncurses 6.4" "Library calls" .SH NAME -\fBform_win\fP \- make and break form window and subwindow associations +\fBform_win\fP \- +make and break form window and subwindow associations .SH SYNOPSIS \fB#include \fP .sp diff --git a/man/infocmp.1m b/man/infocmp.1m index 582cd7ec..2da87669 100644 --- a/man/infocmp.1m +++ b/man/infocmp.1m @@ -28,8 +28,8 @@ .\" authorization. * .\"*************************************************************************** .\" -.\" $Id: infocmp.1m,v 1.90 2023/09/09 21:14:05 tom Exp $ -.TH @INFOCMP@ 1M 2023-09-09 "ncurses 6.4" "User commands" +.\" $Id: infocmp.1m,v 1.92 2023/09/16 23:37:03 tom Exp $ +.TH @INFOCMP@ 1M 2023-09-16 "ncurses 6.4" "User commands" .ie \n(.g .ds `` \(lq .el .ds `` `` .ie \n(.g .ds '' \(rq @@ -60,7 +60,8 @@ .. .ds d @TERMINFO@ .SH NAME -\fB@INFOCMP@\fP \- compare or print out \fIterminfo\fP descriptions +\fB@INFOCMP@\fP \- +compare or print out \fIterminfo\fP descriptions .SH SYNOPSIS \fB@INFOCMP@\fP [\fB\-\ 1\ diff --git a/man/infotocap.1m b/man/infotocap.1m index 12820720..1d74088a 100644 --- a/man/infotocap.1m +++ b/man/infotocap.1m @@ -1,6 +1,6 @@ '\" t .\"*************************************************************************** -.\" Copyright 2018-2021,2022 Thomas E. Dickey * +.\" Copyright 2018-2022,2023 Thomas E. Dickey * .\" Copyright 1999-2010,2016 Free Software Foundation, Inc. * .\" * .\" Permission is hereby granted, free of charge, to any person obtaining a * @@ -28,12 +28,13 @@ .\" authorization. * .\"*************************************************************************** .\" -.\" $Id: infotocap.1m,v 1.21 2022/02/12 20:02:20 tom Exp $ -.TH @INFOTOCAP@ 1M 2022-02-12 "ncurses 6.4" "User commands" +.\" $Id: infotocap.1m,v 1.26 2023/09/16 23:38:39 tom Exp $ +.TH @INFOTOCAP@ 1M 2023-09-16 "ncurses 6.4" "User commands" .ds n 5 .ds d @TERMINFO@ .SH NAME -\fB@INFOTOCAP@\fP \- convert a \fIterminfo\fP description into a \fItermcap\fP description +\fB\%@INFOTOCAP@\fP \- +convert a \fIterminfo\fR description into a \fItermcap\fR description .SH SYNOPSIS \fB@INFOTOCAP@\fR [\fB\-v\fIn\fR \fIwidth\fR] [\fB\-V\fR] [\fB\-1\fR] [\fB\-w\fR \fIwidth\fR] \fIfile\fR ... .SH DESCRIPTION diff --git a/man/key_defined.3x b/man/key_defined.3x index 5614e1ce..5e140551 100644 --- a/man/key_defined.3x +++ b/man/key_defined.3x @@ -1,5 +1,5 @@ .\"*************************************************************************** -.\" Copyright 2018-2021,2022 Thomas E. Dickey * +.\" Copyright 2018-2022,2023 Thomas E. Dickey * .\" Copyright 2003-2006,2010 Free Software Foundation, Inc. * .\" * .\" Permission is hereby granted, free of charge, to any person obtaining a * @@ -29,10 +29,11 @@ .\" .\" Author: Thomas E. Dickey 2003 .\" -.\" $Id: key_defined.3x,v 1.14 2022/02/12 20:03:40 tom Exp $ -.TH key_defined 3X 2022-02-12 "ncurses 6.4" "Library calls" +.\" $Id: key_defined.3x,v 1.20 2023/09/16 23:38:39 tom Exp $ +.TH key_defined 3X 2023-09-16 "ncurses 6.4" "Library calls" .SH NAME -\fBkey_defined\fP \- check if a keycode is defined +\fB\%key_defined\fP \- +test whether a \fIcurses\fR keycode is defined .SH SYNOPSIS \fB#include \fP .sp @@ -47,8 +48,8 @@ If no keycode is bound, zero is returned. If the string conflicts with longer strings which are bound to keys, \-1 is returned. .SH PORTABILITY -These routines are specific to ncurses. -They were not supported on +This routine is specific to ncurses. +It was not supported on Version 7, BSD or System V implementations. It is recommended that any code depending on them be conditioned using NCURSES_VERSION. diff --git a/man/keybound.3x b/man/keybound.3x index 76825c4c..b2dde39c 100644 --- a/man/keybound.3x +++ b/man/keybound.3x @@ -1,5 +1,5 @@ .\"*************************************************************************** -.\" Copyright 2018-2021,2022 Thomas E. Dickey * +.\" Copyright 2018-2022,2023 Thomas E. Dickey * .\" Copyright 1999-2008,2010 Free Software Foundation, Inc. * .\" * .\" Permission is hereby granted, free of charge, to any person obtaining a * @@ -29,10 +29,11 @@ .\" .\" Author: Thomas E. Dickey 1999 .\" -.\" $Id: keybound.3x,v 1.15 2022/02/12 20:03:40 tom Exp $ -.TH keybound 3X 2022-02-12 "ncurses 6.4" "Library calls" +.\" $Id: keybound.3x,v 1.21 2023/09/16 23:38:39 tom Exp $ +.TH keybound 3X 2023-09-16 "ncurses 6.4" "Library calls" .SH NAME -\fBkeybound\fP \- return definition of keycode +\fB\%keybound\fP \- +get definition of \fIcurses\fR keycode .SH SYNOPSIS \fB#include \fP .sp @@ -49,8 +50,8 @@ through multiple definitions, counting from zero. When successful, the function returns a string which must be freed by the caller. .SH PORTABILITY -These routines are specific to ncurses. -They were not supported on +This routine is specific to ncurses. +It was not supported on Version 7, BSD or System V implementations. It is recommended that any code depending on them be conditioned using NCURSES_VERSION. diff --git a/man/keyok.3x b/man/keyok.3x index f69c82e6..7bc1d911 100644 --- a/man/keyok.3x +++ b/man/keyok.3x @@ -1,5 +1,5 @@ .\"*************************************************************************** -.\" Copyright 2018-2021,2022 Thomas E. Dickey * +.\" Copyright 2018-2022,2023 Thomas E. Dickey * .\" Copyright 1998-2010,2017 Free Software Foundation, Inc. * .\" * .\" Permission is hereby granted, free of charge, to any person obtaining a * @@ -29,10 +29,11 @@ .\" .\" Author: Thomas E. Dickey 1997 .\" -.\" $Id: keyok.3x,v 1.20 2022/02/12 20:03:40 tom Exp $ -.TH keyok 3X 2022-02-12 "ncurses 6.4" "Library calls" +.\" $Id: keyok.3x,v 1.26 2023/09/16 23:38:39 tom Exp $ +.TH keyok 3X 2023-09-16 "ncurses 6.4" "Library calls" .SH NAME -\fBkeyok\fP \- enable or disable a keycode +\fB\%keyok\fP \- +enable or disable a \fIcurses\fR keycode .SH SYNOPSIS \fB#include \fP .sp @@ -49,8 +50,8 @@ If the \fIenable\fP parameter is true, then the key must have been disabled, and vice versa. Otherwise, the function returns \fBOK\fP. .SH PORTABILITY -These routines are specific to ncurses. -They were not supported on +This routine is specific to ncurses. +It was not supported on Version 7, BSD or System V implementations. It is recommended that any code depending on them be conditioned using NCURSES_VERSION. diff --git a/man/legacy_coding.3x b/man/legacy_coding.3x index 57d88d80..6dfe1bb8 100644 --- a/man/legacy_coding.3x +++ b/man/legacy_coding.3x @@ -1,5 +1,5 @@ .\"*************************************************************************** -.\" Copyright 2020-2021,2022 Thomas E. Dickey * +.\" Copyright 2020-2022,2023 Thomas E. Dickey * .\" Copyright 2005-2016,2017 Free Software Foundation, Inc. * .\" * .\" Permission is hereby granted, free of charge, to any person obtaining a * @@ -29,10 +29,11 @@ .\" .\" Author: Thomas E. Dickey .\" -.\" $Id: legacy_coding.3x,v 1.12 2022/02/12 20:07:56 tom Exp $ -.TH legacy_coding 3X 2022-02-12 "ncurses 6.4" "Library calls" +.\" $Id: legacy_coding.3x,v 1.17 2023/09/16 23:38:39 tom Exp $ +.TH legacy_coding 3X 2023-09-16 "ncurses 6.4" "Library calls" .SH NAME -\fBuse_legacy_coding\fP \- override locale-encoding checks +\fB\%use_legacy_coding\fP \- +override \fIcurses\fR locale encoding checks .SH SYNOPSIS \fB#include \fP .sp diff --git a/man/manlinks.sed b/man/manlinks.sed index 09b055f2..2f09cbbe 100644 --- a/man/manlinks.sed +++ b/man/manlinks.sed @@ -1,6 +1,6 @@ -# $Id: manlinks.sed,v 1.15 2021/01/05 20:30:00 tom Exp $ +# $Id: manlinks.sed,v 1.19 2023/09/17 08:26:33 tom Exp $ ############################################################################## -# Copyright 2020,2021 Thomas E. Dickey # +# Copyright 2020-2021,2023 Thomas E. Dickey # # Copyright 2000-2003,2008 Free Software Foundation, Inc. # # # # Permission is hereby granted, free of charge, to any person obtaining a # @@ -31,6 +31,9 @@ # listed in the "NAME" section, i.e., the names that we would like to use # as aliases for the manpage -T.Dickey # +# workaround for manpages without a SYNOPSIS +s/^\.\\"SH/.SH/ +# # eliminate formatting controls that get in the way /^'\\"/d /\.\\"/d @@ -39,12 +42,13 @@ /typedef/d s/^\.IX// s/\\f.//g +s/\\%//g s/[:,]/ /g # # ignore C-style comments s%/\*.*\*/%% # -# eliminate unnecessary whitespace, convert multiple blanks to single space +# Eliminate unnecessary whitespace, convert multiple blanks to single space. s/^[ ][ ]*// s/[ ][ ]*$// s/[ ][ ]*/ /g @@ -54,16 +58,16 @@ s/[ ][ ]*/ /g s/\.SH[ ][ ]*/.SH_(/ # # in ".SH NAME" -# change "\-" to "-", eliminate text after "-", and split the remaining lines -# at each space, making a list of names: -/^\.SH_(NAME/,/^\.SH_(SYNOPSIS/{ -s/\\-.*/ -/ -/ -/{ -s/ -.*// -s/ /\ -/g -} -/^-/{ +# Convert a list of names separated from their description by " \-" to a list +# of names on separate lines. Normally the list is also comma-separated, but +# we ignore that detail here. The description is on a separate line to make +# the nroff source more pleasing to some eyes. +/^\.SH_(NAME/,/ \\-$/{ +s/\\-/-/g +s/ / /g +/ -$/{ +s/ -$// +n d } s/ /\ @@ -71,9 +75,14 @@ s/ /\ } # # in ".SH SYNOPSIS" -# remove any line that does not contain a '(', since we only want functions. +# For readability, the NAME section may not contain all function names, but we +# still want to make aliases for those. Do this by extracting names from the +# list of function prototypes in the synopsis. +# +# Remove any line that does not contain a '(', since we only want functions. # then strip off return-type of each function. -# finally, remove the parameter list, which begins with a '('. +# +# Finally, remove the parameter list, which begins with a '('. /^\.SH_(SYNOPSIS/,/^\.SH_(DESCRIPTION/{ /^[^(]*$/d # reduce diff --git a/man/menu.3x b/man/menu.3x index 4b114c48..fa7b03ac 100644 --- a/man/menu.3x +++ b/man/menu.3x @@ -28,8 +28,8 @@ .\" authorization. * .\"*************************************************************************** .\" -.\" $Id: menu.3x,v 1.34 2023/08/19 20:39:40 tom Exp $ -.TH menu 3X 2023-08-19 "ncurses 6.4" "Library calls" +.\" $Id: menu.3x,v 1.36 2023/09/16 23:38:39 tom Exp $ +.TH menu 3X 2023-09-16 "ncurses 6.4" "Library calls" .ie \n(.g .ds `` \(lq .el .ds `` `` .ie \n(.g .ds '' \(rq @@ -39,7 +39,8 @@ .el .IP \(bu 2 .. .SH NAME -\fBmenu\fP \- curses extension for programming menus +\fBmenu\fP \- +curses extension for programming menus .SH SYNOPSIS \fB#include \fP .SH DESCRIPTION diff --git a/man/menu_attributes.3x b/man/menu_attributes.3x index dac377dd..7a35f023 100644 --- a/man/menu_attributes.3x +++ b/man/menu_attributes.3x @@ -28,8 +28,8 @@ .\" authorization. * .\"*************************************************************************** .\" -.\" $Id: menu_attributes.3x,v 1.26 2023/07/01 15:46:10 tom Exp $ -.TH menu_attributes 3X 2023-07-01 "ncurses 6.4" "Library calls" +.\" $Id: menu_attributes.3x,v 1.28 2023/09/16 23:38:39 tom Exp $ +.TH menu_attributes 3X 2023-09-16 "ncurses 6.4" "Library calls" .ie \n(.g .ds `` \(lq .el .ds `` `` .ie \n(.g .ds '' \(rq @@ -42,7 +42,8 @@ \fBset_menu_back\fP, \fBset_menu_fore\fP, \fBset_menu_grey\fP, -\fBset_menu_pad\fP \- color and attribute control for menus +\fBset_menu_pad\fP \- +color and attribute control for menus .SH SYNOPSIS \fB#include \fP .sp diff --git a/man/menu_cursor.3x b/man/menu_cursor.3x index eea54c6d..d7e8e288 100644 --- a/man/menu_cursor.3x +++ b/man/menu_cursor.3x @@ -28,10 +28,11 @@ .\" authorization. * .\"*************************************************************************** .\" -.\" $Id: menu_cursor.3x,v 1.20 2023/07/01 15:46:10 tom Exp $ -.TH menu_cursor 3X 2023-07-01 "ncurses 6.4" "Library calls" +.\" $Id: menu_cursor.3x,v 1.22 2023/09/16 23:38:39 tom Exp $ +.TH menu_cursor 3X 2023-09-16 "ncurses 6.4" "Library calls" .SH NAME -\fBpos_menu_cursor\fP \- position a menu's cursor +\fBpos_menu_cursor\fP \- +position a menu's cursor .SH SYNOPSIS \fB#include \fP .sp diff --git a/man/menu_driver.3x b/man/menu_driver.3x index 7709952f..9891e4a1 100644 --- a/man/menu_driver.3x +++ b/man/menu_driver.3x @@ -27,14 +27,15 @@ .\" authorization. * .\"*************************************************************************** .\" -.\" $Id: menu_driver.3x,v 1.35 2023/07/01 15:46:10 tom Exp $ -.TH menu_driver 3X 2023-07-01 "ncurses 6.4" "Library calls" +.\" $Id: menu_driver.3x,v 1.37 2023/09/16 23:38:39 tom Exp $ +.TH menu_driver 3X 2023-09-16 "ncurses 6.4" "Library calls" .de bP .ie n .IP \(bu 4 .el .IP \(bu 2 .. .SH NAME -\fBmenu_driver\fP \- command-processing loop of the menu system +\fBmenu_driver\fP \- +command-processing loop of the menu system .SH SYNOPSIS \fB#include \fP .sp diff --git a/man/menu_format.3x b/man/menu_format.3x index 0d5ab6ae..ebe79b48 100644 --- a/man/menu_format.3x +++ b/man/menu_format.3x @@ -28,11 +28,12 @@ .\" authorization. * .\"*************************************************************************** .\" -.\" $Id: menu_format.3x,v 1.25 2023/07/01 15:46:10 tom Exp $ -.TH menu_format 3X 2023-07-01 "ncurses 6.4" "Library calls" +.\" $Id: menu_format.3x,v 1.27 2023/09/16 23:38:39 tom Exp $ +.TH menu_format 3X 2023-09-16 "ncurses 6.4" "Library calls" .SH NAME \fBset_menu_format\fP, -\fBmenu_format\fP \- set and get menu sizes +\fBmenu_format\fP \- +set and get menu sizes .SH SYNOPSIS \fB#include \fP .sp diff --git a/man/menu_hook.3x b/man/menu_hook.3x index 3d0533c6..a3b53d9b 100644 --- a/man/menu_hook.3x +++ b/man/menu_hook.3x @@ -28,10 +28,11 @@ .\" authorization. * .\"*************************************************************************** .\" -.\" $Id: menu_hook.3x,v 1.22 2023/07/01 15:46:10 tom Exp $ -.TH menu_hook 3X 2023-07-01 "ncurses 6.4" "Library calls" +.\" $Id: menu_hook.3x,v 1.24 2023/09/16 23:38:39 tom Exp $ +.TH menu_hook 3X 2023-09-16 "ncurses 6.4" "Library calls" .SH NAME -\fBmenu_hook\fP \- set hooks for automatic invocation by applications +\fBmenu_hook\fP \- +set hooks for automatic invocation by applications .SH SYNOPSIS \fB#include \fP .sp diff --git a/man/menu_items.3x b/man/menu_items.3x index 056b22b8..79d383e6 100644 --- a/man/menu_items.3x +++ b/man/menu_items.3x @@ -28,12 +28,13 @@ .\" authorization. * .\"*************************************************************************** .\" -.\" $Id: menu_items.3x,v 1.24 2023/07/01 15:46:10 tom Exp $ -.TH menu_items 3X 2023-07-01 "ncurses 6.4" "Library calls" +.\" $Id: menu_items.3x,v 1.26 2023/09/16 23:38:39 tom Exp $ +.TH menu_items 3X 2023-09-16 "ncurses 6.4" "Library calls" .SH NAME \fBset_menu_items\fP, \fBmenu_items\fP, -\fBitem_count\fP \- make and break connections between items and menus +\fBitem_count\fP \- +make and break connections between items and menus .SH SYNOPSIS \fB#include \fP .sp diff --git a/man/menu_mark.3x b/man/menu_mark.3x index f3afa95e..087832b1 100644 --- a/man/menu_mark.3x +++ b/man/menu_mark.3x @@ -28,11 +28,12 @@ .\" authorization. * .\"*************************************************************************** .\" -.\" $Id: menu_mark.3x,v 1.25 2023/07/01 15:46:10 tom Exp $ -.TH menu_mark 3X 2023-07-01 "ncurses 6.4" "Library calls" +.\" $Id: menu_mark.3x,v 1.27 2023/09/16 23:38:39 tom Exp $ +.TH menu_mark 3X 2023-09-16 "ncurses 6.4" "Library calls" .SH NAME \fBset_menu_mark\fP, -\fBmenu_mark\fP \- get and set the menu mark string +\fBmenu_mark\fP \- +get and set the menu mark string .SH SYNOPSIS \fB#include \fP .sp diff --git a/man/menu_new.3x b/man/menu_new.3x index bd3800a4..7793102d 100644 --- a/man/menu_new.3x +++ b/man/menu_new.3x @@ -28,11 +28,12 @@ .\" authorization. * .\"*************************************************************************** .\" -.\" $Id: menu_new.3x,v 1.25 2023/07/01 15:46:10 tom Exp $ -.TH menu_new 3X 2023-07-01 "ncurses 6.4" "Library calls" +.\" $Id: menu_new.3x,v 1.27 2023/09/16 23:38:39 tom Exp $ +.TH menu_new 3X 2023-09-16 "ncurses 6.4" "Library calls" .SH NAME \fBnew_menu\fP, -\fBfree_menu\fP \- create and destroy menus +\fBfree_menu\fP \- +create and destroy menus .SH SYNOPSIS \fB#include \fP .sp diff --git a/man/menu_opts.3x b/man/menu_opts.3x index 2ed1a826..471d153a 100644 --- a/man/menu_opts.3x +++ b/man/menu_opts.3x @@ -28,13 +28,14 @@ .\" authorization. * .\"*************************************************************************** .\" -.\" $Id: menu_opts.3x,v 1.25 2023/07/01 15:46:10 tom Exp $ -.TH menu_opts 3X 2023-07-01 "ncurses 6.4" "Library calls" +.\" $Id: menu_opts.3x,v 1.27 2023/09/16 23:38:39 tom Exp $ +.TH menu_opts 3X 2023-09-16 "ncurses 6.4" "Library calls" .SH NAME \fBset_menu_opts\fP, \fBmenu_opts_on\fP, \fBmenu_opts_off\fP, -\fBmenu_opts\fP \- set and get menu options +\fBmenu_opts\fP \- +set and get menu options .SH SYNOPSIS \fB#include \fP .sp diff --git a/man/menu_pattern.3x b/man/menu_pattern.3x index 1e3c0a87..fb5372ba 100644 --- a/man/menu_pattern.3x +++ b/man/menu_pattern.3x @@ -27,11 +27,12 @@ .\" authorization. * .\"*************************************************************************** .\" -.\" $Id: menu_pattern.3x,v 1.28 2023/07/01 15:46:10 tom Exp $ -.TH menu_pattern 3X 2023-07-01 "ncurses 6.4" "Library calls" +.\" $Id: menu_pattern.3x,v 1.30 2023/09/16 23:38:39 tom Exp $ +.TH menu_pattern 3X 2023-09-16 "ncurses 6.4" "Library calls" .SH NAME \fBset_menu_pattern\fP, -\fBmenu_pattern\fP \- set and get a menu's pattern buffer +\fBmenu_pattern\fP \- +set and get a menu's pattern buffer .SH SYNOPSIS \fB#include \fP .sp diff --git a/man/menu_post.3x b/man/menu_post.3x index ba618f52..15f232a6 100644 --- a/man/menu_post.3x +++ b/man/menu_post.3x @@ -28,11 +28,12 @@ .\" authorization. * .\"*************************************************************************** .\" -.\" $Id: menu_post.3x,v 1.26 2023/07/01 15:46:10 tom Exp $ -.TH menu_post 3X 2023-07-01 "ncurses 6.4" "Library calls" +.\" $Id: menu_post.3x,v 1.28 2023/09/16 23:38:39 tom Exp $ +.TH menu_post 3X 2023-09-16 "ncurses 6.4" "Library calls" .SH NAME \fBpost_menu\fP, -\fBunpost_menu\fP \- write or erase menus from associated subwindows +\fBunpost_menu\fP \- +write or erase menus from associated subwindows .SH SYNOPSIS \fB#include \fP .sp diff --git a/man/menu_requestname.3x b/man/menu_requestname.3x index c2ffc617..146a45b0 100644 --- a/man/menu_requestname.3x +++ b/man/menu_requestname.3x @@ -28,11 +28,12 @@ .\" authorization. * .\"*************************************************************************** .\" -.\" $Id: menu_requestname.3x,v 1.22 2023/07/01 15:46:10 tom Exp $ -.TH menu_requestname 3X 2023-07-01 "ncurses 6.4" "Library calls" +.\" $Id: menu_requestname.3x,v 1.24 2023/09/16 23:38:39 tom Exp $ +.TH menu_requestname 3X 2023-09-16 "ncurses 6.4" "Library calls" .SH NAME \fBmenu_request_by_name\fP, -\fBmenu_request_name\fP \- handle printable menu request names +\fBmenu_request_name\fP \- +handle printable menu request names .SH SYNOPSIS \fB#include \fP .sp diff --git a/man/menu_spacing.3x b/man/menu_spacing.3x index 8c5ef747..9edc191e 100644 --- a/man/menu_spacing.3x +++ b/man/menu_spacing.3x @@ -28,11 +28,12 @@ .\" authorization. * .\"*************************************************************************** .\" -.\" $Id: menu_spacing.3x,v 1.24 2023/07/01 15:46:10 tom Exp $ -.TH menu_spacing 3X 2023-07-01 "ncurses 6.4" "Library calls" +.\" $Id: menu_spacing.3x,v 1.26 2023/09/16 23:38:39 tom Exp $ +.TH menu_spacing 3X 2023-09-16 "ncurses 6.4" "Library calls" .SH NAME \fBset_menu_spacing\fP, -\fBmenu_spacing\fP \- set and get spacing between menu items. +\fBmenu_spacing\fP \- +set and get spacing between menu items. .SH SYNOPSIS \fB#include \fP .sp diff --git a/man/menu_userptr.3x b/man/menu_userptr.3x index 36bf47f4..31aa9f32 100644 --- a/man/menu_userptr.3x +++ b/man/menu_userptr.3x @@ -28,11 +28,12 @@ .\" authorization. * .\"*************************************************************************** .\" -.\" $Id: menu_userptr.3x,v 1.23 2023/07/01 15:46:10 tom Exp $ -.TH menu_userptr 3X 2023-07-01 "ncurses 6.4" "Library calls" +.\" $Id: menu_userptr.3x,v 1.25 2023/09/16 23:38:39 tom Exp $ +.TH menu_userptr 3X 2023-09-16 "ncurses 6.4" "Library calls" .SH NAME \fBset_menu_userptr\fP, -\fBmenu_userptr\fP \- associate application data with a menu item +\fBmenu_userptr\fP \- +associate application data with a menu item .SH SYNOPSIS \fB#include \fP .sp diff --git a/man/menu_win.3x b/man/menu_win.3x index af95f3b2..47e5bac2 100644 --- a/man/menu_win.3x +++ b/man/menu_win.3x @@ -28,10 +28,11 @@ .\" authorization. * .\"*************************************************************************** .\" -.\" $Id: menu_win.3x,v 1.22 2023/07/01 15:46:10 tom Exp $ -.TH menu_win 3X 2023-07-01 "ncurses 6.4" "Library calls" +.\" $Id: menu_win.3x,v 1.24 2023/09/16 23:38:39 tom Exp $ +.TH menu_win 3X 2023-09-16 "ncurses 6.4" "Library calls" .SH NAME -\fBmenu_win\fP \- make and break menu window and subwindow associations +\fBmenu_win\fP \- +make and break menu window and subwindow associations .SH SYNOPSIS \fB#include \fP .sp diff --git a/man/mitem_current.3x b/man/mitem_current.3x index 6cac7496..456b0284 100644 --- a/man/mitem_current.3x +++ b/man/mitem_current.3x @@ -28,10 +28,11 @@ .\" authorization. * .\"*************************************************************************** .\" -.\" $Id: mitem_current.3x,v 1.27 2023/07/01 15:46:10 tom Exp $ -.TH mitem_current 3X 2023-07-01 "ncurses 6.4" "Library calls" +.\" $Id: mitem_current.3x,v 1.29 2023/09/16 23:38:39 tom Exp $ +.TH mitem_current 3X 2023-09-16 "ncurses 6.4" "Library calls" .SH NAME -\fBmitem_current\fP \- set and get current_menu_item +\fBmitem_current\fP \- +set and get current_menu_item .SH SYNOPSIS \fB#include \fP .sp diff --git a/man/mitem_name.3x b/man/mitem_name.3x index 362a076f..475a541f 100644 --- a/man/mitem_name.3x +++ b/man/mitem_name.3x @@ -28,11 +28,12 @@ .\" authorization. * .\"*************************************************************************** .\" -.\" $Id: mitem_name.3x,v 1.21 2023/07/01 15:46:10 tom Exp $ -.TH mitem_name 3X 2023-07-01 "ncurses 6.4" "Library calls" +.\" $Id: mitem_name.3x,v 1.23 2023/09/16 23:38:39 tom Exp $ +.TH mitem_name 3X 2023-09-16 "ncurses 6.4" "Library calls" .SH NAME \fBitem_name\fP, -\fBitem_description\fP \- get menu item name and description fields +\fBitem_description\fP \- +get menu item name and description fields .SH SYNOPSIS \fB#include \fP .sp diff --git a/man/mitem_new.3x b/man/mitem_new.3x index f7555374..51d14945 100644 --- a/man/mitem_new.3x +++ b/man/mitem_new.3x @@ -28,11 +28,12 @@ .\" authorization. * .\"*************************************************************************** .\" -.\" $Id: mitem_new.3x,v 1.26 2023/07/01 15:46:10 tom Exp $ -.TH mitem_new 3X 2023-07-01 "ncurses 6.4" "Library calls" +.\" $Id: mitem_new.3x,v 1.28 2023/09/16 23:38:39 tom Exp $ +.TH mitem_new 3X 2023-09-16 "ncurses 6.4" "Library calls" .SH NAME \fBnew_item\fP, -\fBfree_item\fP \- create and destroy menu items +\fBfree_item\fP \- +create and destroy menu items .SH SYNOPSIS \fB#include \fP .sp diff --git a/man/mitem_opts.3x b/man/mitem_opts.3x index 485dc9e1..36ac3062 100644 --- a/man/mitem_opts.3x +++ b/man/mitem_opts.3x @@ -28,13 +28,14 @@ .\" authorization. * .\"*************************************************************************** .\" -.\" $Id: mitem_opts.3x,v 1.23 2023/07/01 15:46:10 tom Exp $ -.TH mitem_opts 3X 2023-07-01 "ncurses 6.4" "Library calls" +.\" $Id: mitem_opts.3x,v 1.25 2023/09/16 23:38:39 tom Exp $ +.TH mitem_opts 3X 2023-09-16 "ncurses 6.4" "Library calls" .SH NAME \fBset_item_opts\fP, \fBitem_opts_on\fP, \fBitem_opts_off\fP, -\fBitem_opts\fP \- set and get menu item options +\fBitem_opts\fP \- +set and get menu item options .SH SYNOPSIS \fB#include \fP .sp diff --git a/man/mitem_userptr.3x b/man/mitem_userptr.3x index 76848812..7cfe7ae1 100644 --- a/man/mitem_userptr.3x +++ b/man/mitem_userptr.3x @@ -28,11 +28,12 @@ .\" authorization. * .\"*************************************************************************** .\" -.\" $Id: mitem_userptr.3x,v 1.24 2023/07/01 15:46:10 tom Exp $ -.TH mitem_userptr 3X 2023-07-01 "ncurses 6.4" "Library calls" +.\" $Id: mitem_userptr.3x,v 1.26 2023/09/16 23:38:39 tom Exp $ +.TH mitem_userptr 3X 2023-09-16 "ncurses 6.4" "Library calls" .SH NAME \fBset_item_userptr\fP, -\fBitem_userptr\fP \- associate application data with a menu item +\fBitem_userptr\fP \- +associate application data with a menu item .SH SYNOPSIS \fB#include \fP .sp diff --git a/man/mitem_value.3x b/man/mitem_value.3x index 15751e74..684591c0 100644 --- a/man/mitem_value.3x +++ b/man/mitem_value.3x @@ -27,11 +27,12 @@ .\" authorization. * .\"*************************************************************************** .\" -.\" $Id: mitem_value.3x,v 1.22 2023/07/01 15:46:10 tom Exp $ -.TH mitem_value 3X 2023-07-01 "ncurses 6.4" "Library calls" +.\" $Id: mitem_value.3x,v 1.24 2023/09/16 23:38:39 tom Exp $ +.TH mitem_value 3X 2023-09-16 "ncurses 6.4" "Library calls" .SH NAME \fBset_item_value\fP, -\fBitem_value\fP \- set and get menu item values +\fBitem_value\fP \- +set and get menu item values .SH SYNOPSIS \fB#include \fP .sp diff --git a/man/mitem_visible.3x b/man/mitem_visible.3x index 865a9d9d..b2efded5 100644 --- a/man/mitem_visible.3x +++ b/man/mitem_visible.3x @@ -28,10 +28,11 @@ .\" authorization. * .\"*************************************************************************** .\" -.\" $Id: mitem_visible.3x,v 1.17 2023/07/01 15:46:10 tom Exp $ -.TH mitem_visible 3X 2023-07-01 "ncurses 6.4" "Library calls" +.\" $Id: mitem_visible.3x,v 1.19 2023/09/16 23:38:39 tom Exp $ +.TH mitem_visible 3X 2023-09-16 "ncurses 6.4" "Library calls" .SH NAME -\fBmitem_visible\fP \- check visibility of a menu item +\fBmitem_visible\fP \- +check visibility of a menu item .SH SYNOPSIS \fB#include \fP .sp diff --git a/man/ncurses.3x b/man/ncurses.3x index 5bd9d5f5..10878e1c 100644 --- a/man/ncurses.3x +++ b/man/ncurses.3x @@ -28,9 +28,8 @@ .\" authorization. * .\"*************************************************************************** .\" -.\" $Id: ncurses.3x,v 1.167 2023/09/09 21:11:08 tom Exp $ -.hy 0 -.TH ncurses 3X 2023-09-09 "ncurses 6.4" "Library calls" +.\" $Id: ncurses.3x,v 1.171 2023/09/16 23:38:39 tom Exp $ +.TH ncurses 3X 2023-09-16 "ncurses 6.4" "Library calls" .ie \n(.g .ds `` \(lq .el .ds `` `` .ie \n(.g .ds '' \(rq @@ -61,7 +60,8 @@ .ds n 5 .ds d @TERMINFO@ .SH NAME -\fBncurses\fP \- CRT screen handling and optimization package +\fB\%ncurses\fP \- +character-cell terminal interface with optimized output .SH SYNOPSIS \fB#include \fP .SH DESCRIPTION diff --git a/man/new_pair.3x b/man/new_pair.3x index 38203fd8..772d09eb 100644 --- a/man/new_pair.3x +++ b/man/new_pair.3x @@ -29,8 +29,8 @@ .\" .\" Author: Thomas E. Dickey .\" -.\" $Id: new_pair.3x,v 1.26 2023/09/09 21:20:16 tom Exp $ -.TH new_pair 3X 2023-09-09 "ncurses 6.4" "Library calls" +.\" $Id: new_pair.3x,v 1.30 2023/09/16 23:38:39 tom Exp $ +.TH new_pair 3X 2023-09-16 "ncurses 6.4" "Library calls" .ie \n(.g .ds `` \(lq .el .ds `` `` .ie \n(.g .ds '' \(rq @@ -59,9 +59,10 @@ .el .in -2 .. .SH NAME -\fBalloc_pair\fP, -\fBfind_pair\fP, -\fBfree_pair\fP \- new curses color-pair functions +\fB\%alloc_pair\fP, +\fB\%find_pair\fP, +\fB\%free_pair\fP \- +dynamically allocate \fIcurses\fR color pairs .SH SYNOPSIS \fB#include \fP .sp diff --git a/man/panel.3x b/man/panel.3x index fded6f2c..56ea1cd2 100644 --- a/man/panel.3x +++ b/man/panel.3x @@ -27,8 +27,8 @@ .\" authorization. * .\"*************************************************************************** .\" -.\" $Id: panel.3x,v 1.48 2023/08/19 21:01:21 tom Exp $ -.TH panel 3X 2023-08-19 "ncurses 6.4" "Library calls" +.\" $Id: panel.3x,v 1.50 2023/09/16 23:38:39 tom Exp $ +.TH panel 3X 2023-09-16 "ncurses 6.4" "Library calls" .ie \n(.g .ds `` \(lq .el .ds `` `` .ie \n(.g .ds '' \(rq @@ -38,7 +38,8 @@ .el .IP \(bu 2 .. .SH NAME -panel \- panel stack extension for curses +panel \- +panel stack extension for curses .SH SYNOPSIS \fB#include \fP .P diff --git a/man/resizeterm.3x b/man/resizeterm.3x index 3830c92e..73b8d3f0 100644 --- a/man/resizeterm.3x +++ b/man/resizeterm.3x @@ -29,16 +29,17 @@ .\" .\" Author: Thomas E. Dickey 1996-on .\" -.\" $Id: resizeterm.3x,v 1.36 2023/07/01 15:46:10 tom Exp $ -.TH resizeterm 3X 2023-07-01 "ncurses 6.4" "Library calls" +.\" $Id: resizeterm.3x,v 1.40 2023/09/16 23:38:39 tom Exp $ +.TH resizeterm 3X 2023-09-16 "ncurses 6.4" "Library calls" .de bP .ie n .IP \(bu 4 .el .IP \(bu 2 .. .SH NAME -\fBis_term_resized\fP, -\fBresize_term\fP, -\fBresizeterm\fP \- change the curses terminal size +\fB\%is_term_resized\fP, +\fB\%resize_term\fP, +\fB\%resizeterm\fP \- +manage the terminal dimensions understood by \fIcurses\fR .SH SYNOPSIS \fB#include \fP .sp diff --git a/man/scr_dump.5 b/man/scr_dump.5 index 2a2203be..5eaa7f79 100644 --- a/man/scr_dump.5 +++ b/man/scr_dump.5 @@ -27,8 +27,8 @@ .\" authorization. * .\"*************************************************************************** .\" -.\" $Id: scr_dump.5,v 1.27 2023/09/09 21:20:16 tom Exp $ -.TH scr_dump 5 2023-09-09 "ncurses 6.4" "File formats" +.\" $Id: scr_dump.5,v 1.31 2023/09/16 23:38:39 tom Exp $ +.TH scr_dump 5 2023-09-16 "ncurses 6.4" "File formats" .ie \n(.g .ds `` \(lq .el .ds `` `` .ie \n(.g .ds '' \(rq @@ -57,7 +57,8 @@ .el .IP \(bu 2 .. .SH NAME -scr_dump \- format of curses screen-dumps. +scr_dump \- +\fIcurses\fR screen dump .SH SYNOPSIS .B scr_dump .SH DESCRIPTION diff --git a/man/tabs.1 b/man/tabs.1 index 8b83c1d0..f406eeb8 100644 --- a/man/tabs.1 +++ b/man/tabs.1 @@ -27,8 +27,8 @@ .\" authorization. * .\"*************************************************************************** .\" -.\" $Id: tabs.1,v 1.41 2023/09/09 21:19:07 tom Exp $ -.TH @TABS@ 1 2023-09-09 "ncurses 6.4" "User commands" +.\" $Id: tabs.1,v 1.44 2023/09/16 23:38:39 tom Exp $ +.TH @TABS@ 1 2023-09-16 "ncurses 6.4" "User commands" .ds n 5 .ie \n(.g .ds `` \(lq .el .ds `` `` @@ -58,7 +58,8 @@ .el .in -2 .. .SH NAME -\fB@TABS@\fP \- set tabs on a terminal +\fB\%@TABS@\fP \- +set terminal tab stops .SH SYNOPSIS \fB@TABS@\fP [\fIoptions\fP]] \fI[tabstop-list]\fP .SH DESCRIPTION diff --git a/man/term.5 b/man/term.5 index d8ba7ac7..2db2d502 100644 --- a/man/term.5 +++ b/man/term.5 @@ -27,8 +27,8 @@ .\" authorization. * .\"*************************************************************************** .\" -.\" $Id: term.5,v 1.52 2023/09/09 17:14:44 tom Exp $ -.TH term 5 2023-09-09 "ncurses 6.4" "File formats" +.\" $Id: term.5,v 1.56 2023/09/16 23:38:39 tom Exp $ +.TH term 5 2023-09-16 "ncurses 6.4" "File formats" .ie \n(.g .ds `` \(lq .el .ds `` `` .ie \n(.g .ds '' \(rq @@ -59,7 +59,8 @@ .ds n 5 .ds d @TERMINFO@ .SH NAME -term \- format of compiled term file. +term \- +compiled \fIterminfo\fR terminal description .SH SYNOPSIS .B term .SH DESCRIPTION diff --git a/man/term.7 b/man/term.7 index 6b52ce29..b6a4da94 100644 --- a/man/term.7 +++ b/man/term.7 @@ -27,8 +27,8 @@ .\" authorization. * .\"*************************************************************************** .\" -.\" $Id: term.7,v 1.35 2023/07/01 15:46:10 tom Exp $ -.TH term 7 2023-07-01 "ncurses 6.4" Miscellaneous +.\" $Id: term.7,v 1.36 2023/09/17 00:10:28 tom Exp $ +.TH term 7 2023-09-16 "ncurses 6.4" Miscellaneous .ie \n(.g .ds `` \(lq .el .ds `` `` .ie \n(.g .ds '' \(rq @@ -36,7 +36,9 @@ .ds n 5 .ds d @TERMINFO@ .SH NAME -term \- conventions for naming terminal types +term \- +conventions for naming terminal types +.\"SH SYNOPSIS .SH DESCRIPTION The environment variable \fBTERM\fP should normally contain the type name of the terminal, console or display-device type you are using. diff --git a/man/term_variables.3x b/man/term_variables.3x index 68028cb0..fe81b660 100644 --- a/man/term_variables.3x +++ b/man/term_variables.3x @@ -27,8 +27,8 @@ .\" authorization. * .\"*************************************************************************** .\" -.\" $Id: term_variables.3x,v 1.23 2023/09/09 17:06:25 tom Exp $ -.TH term_variables 3X 2023-09-09 "ncurses 6.4" "Library calls" +.\" $Id: term_variables.3x,v 1.27 2023/09/16 23:38:39 tom Exp $ +.TH term_variables 3X 2023-09-16 "ncurses 6.4" "Library calls" .ds n 5 .ie \n(.g .ds `` \(lq .el .ds `` `` @@ -39,25 +39,21 @@ .ie \n(.g .ds CW CR .el .ds CW CW .\} -.na -.hy 0 .SH NAME -\fBSP\fP, -\fBacs_map\fP, -\fBboolcodes\fP, -\fBboolfnames\fP, -\fBboolnames\fP, -\fBcur_term\fP, -\fBnumcodes\fP, -\fBnumfnames\fP, -\fBnumnames\fP, -\fBstrcodes\fP, -\fBstrfnames\fP, -\fBstrnames\fP, -\fBttytype\fP -\- \fBcurses\fP terminfo global variables -.ad -.hy +\fB\%SP\fP, +\fB\%acs_map\fP, +\fB\%boolcodes\fP, +\fB\%boolfnames\fP, +\fB\%boolnames\fP, +\fB\%cur_term\fP, +\fB\%numcodes\fP, +\fB\%numfnames\fP, +\fB\%numnames\fP, +\fB\%strcodes\fP, +\fB\%strfnames\fP, +\fB\%strnames\fP, +\fB\%ttytype\fP \- +\fIterminfo\fR global variables .SH SYNOPSIS .nf \fB#include \fP diff --git a/man/terminfo.head b/man/terminfo.head index ab24174e..b114b4d8 100644 --- a/man/terminfo.head +++ b/man/terminfo.head @@ -27,8 +27,8 @@ .\" authorization. * .\"*************************************************************************** .\" -.\" $Id: terminfo.head,v 1.48 2023/09/09 21:34:18 tom Exp $ -.TH terminfo 5 2023-09-09 "ncurses @NCURSES_MAJOR@.@NCURSES_MINOR@" "File formats" +.\" $Id: terminfo.head,v 1.51 2023/09/17 08:29:38 tom Exp $ +.TH terminfo 5 2023-09-17 "ncurses @NCURSES_MAJOR@.@NCURSES_MINOR@" "File formats" .ds n 5 .ds d @TERMINFO@ .ie \n(.g .ds `` \(lq @@ -63,7 +63,8 @@ .el .in -2 .. .SH NAME -terminfo \- terminal capability database +\fB\%terminfo\fP \- +terminal capability database .SH SYNOPSIS \*d/*/* .SH DESCRIPTION diff --git a/man/terminfo.tail b/man/terminfo.tail index 05c0426a..2ce4c1bb 100644 --- a/man/terminfo.tail +++ b/man/terminfo.tail @@ -27,7 +27,7 @@ .\" authorization. * .\"*************************************************************************** .\" -.\" $Id: terminfo.tail,v 1.130 2023/09/09 17:08:08 tom Exp $ +.\" $Id: terminfo.tail,v 1.131 2023/09/16 17:01:55 Branden.Robinson Exp $ .ps +1 .SS User-Defined Capabilities . @@ -2092,6 +2092,9 @@ Supports both the SVr4 set and the AIX extensions. .TP 25 \*d/?/* files containing terminal descriptions +.SH AUTHORS +Zeyd M. Ben-Halim, Eric S. Raymond, Thomas E. Dickey. +Based on \fIpcurses\fP by Pavel Curtis. .SH SEE ALSO .na .hy 0 @@ -2105,6 +2108,3 @@ files containing terminal descriptions \fBterm_variables\fP(3X). \fBterm\fP(\*n). \fBuser_caps\fP(5). -.SH AUTHORS -Zeyd M. Ben-Halim, Eric S. Raymond, Thomas E. Dickey. -Based on \fIpcurses\fP by Pavel Curtis. diff --git a/man/tic.1m b/man/tic.1m index ce8b0043..d9bb24bf 100644 --- a/man/tic.1m +++ b/man/tic.1m @@ -27,8 +27,8 @@ .\" authorization. * .\"*************************************************************************** .\" -.\" $Id: tic.1m,v 1.89 2023/09/02 22:29:35 tom Exp $ -.TH @TIC@ 1M 2023-09-02 "ncurses 6.4" "User commands" +.\" $Id: tic.1m,v 1.93 2023/09/16 23:38:39 tom Exp $ +.TH @TIC@ 1M 2023-09-16 "ncurses 6.4" "User commands" .ie \n(.g .ds `` \(lq .el .ds `` `` .ie \n(.g .ds '' \(rq @@ -40,7 +40,8 @@ .el .IP \(bu 2 .. .SH NAME -\fB@TIC@\fP \- the \fIterminfo\fP entry-description compiler +\fB\%@TIC@\fP \- +compile terminal descriptions for \fIterminfo\fR or \fItermcap\fR .SH SYNOPSIS \fB@TIC@\fP [\fB\-\ diff --git a/man/toe.1m b/man/toe.1m index f67566b7..c0325e81 100644 --- a/man/toe.1m +++ b/man/toe.1m @@ -27,8 +27,8 @@ .\" authorization. * .\"*************************************************************************** .\" -.\" $Id: toe.1m,v 1.42 2023/09/09 21:15:25 tom Exp $ -.TH @TOE@ 1M 2023-09-09 "ncurses 6.4" "User commands" +.\" $Id: toe.1m,v 1.46 2023/09/16 23:38:39 tom Exp $ +.TH @TOE@ 1M 2023-09-16 "ncurses 6.4" "User commands" .de bP .ie n .IP \(bu 4 .el .IP \(bu 2 @@ -59,7 +59,8 @@ .ds n 5 .ds d @TERMINFO@ .SH NAME -\fB@TOE@\fP \- table of (terminfo) entries +\fB\%@TOE@\fP \- +list table of entries of \fIterminfo\fR terminal types .SH SYNOPSIS \fB@TOE@\fP [\fB\-v\fP[\fIn\fP]] [\fB\-ahsuUV\fP] \fIfile...\fP .SH DESCRIPTION diff --git a/man/tput.1 b/man/tput.1 index 5ee14d5c..93cf0e02 100644 --- a/man/tput.1 +++ b/man/tput.1 @@ -28,8 +28,8 @@ .\" authorization. * .\"*************************************************************************** .\" -.\" $Id: tput.1,v 1.79 2023/07/01 15:46:10 tom Exp $ -.TH @TPUT@ 1 2023-07-01 "ncurses 6.4" "User commands" +.\" $Id: tput.1,v 1.83 2023/09/16 23:38:39 tom Exp $ +.TH @TPUT@ 1 2023-09-16 "ncurses 6.4" "User commands" .ds d @TERMINFO@ .ds n 1 .ie \n(.g .ds `` \(lq @@ -41,7 +41,9 @@ .el .IP \(bu 2 .. .SH NAME -\fB@TPUT@\fP, \fBreset\fP \- initialize a terminal or query terminfo database +\fB\%@TPUT@\fP, +\fB\%reset\fP \- +initialize a terminal or query \fIterminfo\fR database .SH SYNOPSIS \fB@TPUT@\fR [\fB\-T\fItype\fR] \fIcapname\fR [\fIparameters\fR] .br diff --git a/man/tset.1 b/man/tset.1 index 92268f67..92d91a35 100644 --- a/man/tset.1 +++ b/man/tset.1 @@ -27,8 +27,8 @@ .\" authorization. * .\"*************************************************************************** .\" -.\" $Id: tset.1,v 1.66 2023/07/01 15:21:06 tom Exp $ -.TH @TSET@ 1 2023-07-01 "ncurses 6.4" "User commands" +.\" $Id: tset.1,v 1.69 2023/09/16 23:38:39 tom Exp $ +.TH @TSET@ 1 2023-09-16 "ncurses 6.4" "User commands" .ie \n(.g .ds `` \(lq .el .ds `` `` .ie \n(.g .ds '' \(rq @@ -38,7 +38,9 @@ .el .IP \(bu 2 .. .SH NAME -\fB@TSET@\fP, \fB@RESET@\fP \- terminal initialization +\fB\%@TSET@\fP, +\fB\%@RESET@\fP \- +initialize or reset terminal state .SH SYNOPSIS \fB@TSET@\fP [\fB\-IQVcqrsw\fP] [\fB\-\fP] [\fB\-e\fP \fIch\fP] [\fB\-i\fP \fIch\fP] [\fB\-k\fP \fIch\fP] [\fB\-m\fP \fImapping\fP] [\fIterminal\fP] .br diff --git a/man/user_caps.5 b/man/user_caps.5 index 0ca74be8..8e19116b 100644 --- a/man/user_caps.5 +++ b/man/user_caps.5 @@ -28,8 +28,8 @@ .\" authorization. * .\"*************************************************************************** .\" -.\" $Id: user_caps.5,v 1.32 2023/09/09 21:25:30 tom Exp $ -.TH user_caps 5 2023-09-09 "ncurses 6.4" "File formats" +.\" $Id: user_caps.5,v 1.36 2023/09/16 23:38:39 tom Exp $ +.TH user_caps 5 2023-09-16 "ncurses 6.4" "File formats" .ie \n(.g .ds `` \(lq .el .ds `` `` .ie \n(.g .ds '' \(rq @@ -39,7 +39,8 @@ .el .IP \(bu 2 .. .SH NAME -user_caps \- user-defined terminfo capabilities +user_caps \- +user-defined \fIterminfo\fR capability format .SH SYNOPSIS .B @TIC@ -x, @INFOCMP@ -x .SH DESCRIPTION diff --git a/man/wresize.3x b/man/wresize.3x index c52970ea..c07f284f 100644 --- a/man/wresize.3x +++ b/man/wresize.3x @@ -29,10 +29,11 @@ .\" .\" Author: Thomas E. Dickey 1996 .\" -.\" $Id: wresize.3x,v 1.24 2023/07/01 15:46:10 tom Exp $ -.TH wresize 3X 2023-07-01 "ncurses 6.4" "Library calls" +.\" $Id: wresize.3x,v 1.28 2023/09/16 23:38:39 tom Exp $ +.TH wresize 3X 2023-09-16 "ncurses 6.4" "Library calls" .SH NAME -\fBwresize\fP \- resize a curses window +\fB\%wresize\fP \- +resize a \fIcurses\fR window .SH SYNOPSIS \fB#include \fP .sp diff --git a/menu/m_global.c b/menu/m_global.c index 4ec08c52..4bc8ef8f 100644 --- a/menu/m_global.c +++ b/menu/m_global.c @@ -1,5 +1,5 @@ /**************************************************************************** - * Copyright 2020,2021 Thomas E. Dickey * + * Copyright 2020-2021,2023 Thomas E. Dickey * * Copyright 1998-2012,2014 Free Software Foundation, Inc. * * * * Permission is hereby granted, free of charge, to any person obtaining a * @@ -38,7 +38,7 @@ #include "menu.priv.h" -MODULE_ID("$Id: m_global.c,v 1.33 2021/03/27 23:46:29 tom Exp $") +MODULE_ID("$Id: m_global.c,v 1.34 2023/09/16 16:39:26 tom Exp $") static char mark[] = "-"; /* *INDENT-OFF* */ @@ -568,7 +568,7 @@ _nc_New_TopRow_and_CurrentItem( cur_item = menu->curitem; assert(cur_item); menu->toprow = (short)(((menu->rows - menu->frows) >= 0) - ? min(menu->rows - menu->frows, new_toprow) + ? Min(menu->rows - menu->frows, new_toprow) : 0); menu->curitem = new_current_item; @@ -592,7 +592,7 @@ _nc_New_TopRow_and_CurrentItem( else { /* if we are not posted, this is quite simple */ menu->toprow = (short)(((menu->rows - menu->frows) >= 0) - ? min(menu->rows - menu->frows, new_toprow) + ? Min(menu->rows - menu->frows, new_toprow) : 0); menu->curitem = new_current_item; } diff --git a/ncurses/base/lib_color.c b/ncurses/base/lib_color.c index b61d44a6..f001b224 100644 --- a/ncurses/base/lib_color.c +++ b/ncurses/base/lib_color.c @@ -1,5 +1,5 @@ /**************************************************************************** - * Copyright 2018-2021,2022 Thomas E. Dickey * + * Copyright 2018-2022,2023 Thomas E. Dickey * * Copyright 1998-2016,2017 Free Software Foundation, Inc. * * * * Permission is hereby granted, free of charge, to any person obtaining a * @@ -49,7 +49,7 @@ #define CUR SP_TERMTYPE #endif -MODULE_ID("$Id: lib_color.c,v 1.149 2022/04/30 18:36:54 tom Exp $") +MODULE_ID("$Id: lib_color.c,v 1.150 2023/09/16 16:39:15 tom Exp $") #ifdef USE_TERM_DRIVER #define CanChange InfoOf(SP_PARM).canchange @@ -745,7 +745,7 @@ _nc_init_color(SCREEN *sp, int color, int r, int g, int b) NCURSES_PUTP2("initialize_color", TIPARM_4(initialize_color, color, r, g, b)); #endif - sp->_color_defs = max(color + 1, sp->_color_defs); + sp->_color_defs = Max(color + 1, sp->_color_defs); result = OK; } diff --git a/ncurses/base/lib_overlay.c b/ncurses/base/lib_overlay.c index 6d451d04..6d21c761 100644 --- a/ncurses/base/lib_overlay.c +++ b/ncurses/base/lib_overlay.c @@ -1,5 +1,5 @@ /**************************************************************************** - * Copyright 2020 Thomas E. Dickey * + * Copyright 2020,2023 Thomas E. Dickey * * Copyright 1998-2013,2016 Free Software Foundation, Inc. * * * * Permission is hereby granted, free of charge, to any person obtaining a * @@ -41,7 +41,7 @@ #include -MODULE_ID("$Id: lib_overlay.c,v 1.33 2020/02/02 23:34:34 tom Exp $") +MODULE_ID("$Id: lib_overlay.c,v 1.34 2023/09/16 16:39:07 tom Exp $") static int overlap(const WINDOW *const src, WINDOW *const dst, int const flag) @@ -78,12 +78,12 @@ overlap(const WINDOW *const src, WINDOW *const dst, int const flag) dy2 = dy1 + dst->_maxy; if (dx2 >= sx1 && dx1 <= sx2 && dy2 >= sy1 && dy1 <= sy2) { - int sminrow = max(sy1, dy1) - sy1; - int smincol = max(sx1, dx1) - sx1; - int dminrow = max(sy1, dy1) - dy1; - int dmincol = max(sx1, dx1) - dx1; - int dmaxrow = min(sy2, dy2) - dy1; - int dmaxcol = min(sx2, dx2) - dx1; + int sminrow = Max(sy1, dy1) - sy1; + int smincol = Max(sx1, dx1) - sx1; + int dminrow = Max(sy1, dy1) - dy1; + int dmincol = Max(sx1, dx1) - dx1; + int dmaxrow = Min(sy2, dy2) - dy1; + int dmaxcol = Min(sx2, dx2) - dx1; rc = copywin(src, dst, sminrow, smincol, diff --git a/ncurses/curses.priv.h b/ncurses/curses.priv.h index 0c09d263..7946d56f 100644 --- a/ncurses/curses.priv.h +++ b/ncurses/curses.priv.h @@ -35,7 +35,7 @@ ****************************************************************************/ /* - * $Id: curses.priv.h,v 1.672 2023/09/09 23:13:32 tom Exp $ + * $Id: curses.priv.h,v 1.674 2023/09/16 16:31:14 tom Exp $ * * curses.priv.h * @@ -875,6 +875,12 @@ typedef int (*TYPE_Gpm_GetEvent) (Gpm_Event *); #endif /* HAVE_LIBDL */ #endif /* USE_GPM_SUPPORT */ +/* + * Limit delay-times to 30 seconds, which is consistent with signed 16-bit + * numbers in legacy terminfo. + */ +#define MAX_DELAY_MSECS 30000 + /* * When converting from terminfo to termcap, check for cases where we can trim * octal escapes down to 2-character form. It is useful for terminfo format @@ -1292,12 +1298,12 @@ extern NCURSES_EXPORT_VAR(SIG_ATOMIC_T) _nc_have_sigwinch; /* Checks for isprint() should be done on 8-bit characters (non-wide) */ #define is8bits(c) ((unsigned)(c) <= UCHAR_MAX) -#ifndef min -#define min(a,b) ((a) > (b) ? (b) : (a)) +#ifndef Min +#define Min(a,b) ((a) > (b) ? (b) : (a)) #endif -#ifndef max -#define max(a,b) ((a) < (b) ? (b) : (a)) +#ifndef Max +#define Max(a,b) ((a) < (b) ? (b) : (a)) #endif /* usually in */ diff --git a/ncurses/doit b/ncurses/doit new file mode 100644 index 00000000..ca093ee9 --- /dev/null +++ b/ncurses/doit @@ -0,0 +1 @@ +TERM=vxt-delay ASAN_OPTIONS=detect_odr_violation=0 ./lib_mvcur diff --git a/ncurses/term.priv.h b/ncurses/term.priv.h index 03669cb4..37547180 100644 --- a/ncurses/term.priv.h +++ b/ncurses/term.priv.h @@ -1,5 +1,5 @@ /**************************************************************************** - * Copyright 2021 Thomas E. Dickey * + * Copyright 2021,2023 Thomas E. Dickey * * * * Permission is hereby granted, free of charge, to any person obtaining a * * copy of this software and associated documentation files (the * @@ -27,13 +27,12 @@ ****************************************************************************/ /* - * $Id: term.priv.h,v 1.7 2021/11/20 23:33:33 tom Exp $ + * $Id: term.priv.h,v 1.8 2023/09/16 15:16:38 tom Exp $ * * term.priv.h * * Header file for terminfo library objects which are private to * the library. - * */ #ifndef _TERM_PRIV_H @@ -46,6 +45,10 @@ extern "C" { #include +#ifndef __NCURSES_H +#include +#endif + #undef NCURSES_OPAQUE #define NCURSES_INTERNALS 1 #define NCURSES_OPAQUE 0 diff --git a/ncurses/tinfo/alloc_entry.c b/ncurses/tinfo/alloc_entry.c index 55f51fb6..6280ad4a 100644 --- a/ncurses/tinfo/alloc_entry.c +++ b/ncurses/tinfo/alloc_entry.c @@ -48,7 +48,7 @@ #include -MODULE_ID("$Id: alloc_entry.c,v 1.78 2023/09/09 16:06:00 Nicholas.Marriott Exp $") +MODULE_ID("$Id: alloc_entry.c,v 1.79 2023/09/15 08:16:12 tom Exp $") #define ABSENT_OFFSET -1 #define CANCELLED_OFFSET -2 @@ -158,8 +158,7 @@ _nc_wrap_entry(ENTRY * const ep, bool copy_strings) /* copy term_names, Strings, uses */ tp->term_names = _nc_save_str(tp->term_names); for_each_string(i, tp) { - if (tp->Strings[i] != ABSENT_STRING && - tp->Strings[i] != CANCELLED_STRING) { + if (VALID_STRING(tp->Strings[i])) { tp->Strings[i] = _nc_save_str(tp->Strings[i]); } } diff --git a/ncurses/tinfo/init_keytry.c b/ncurses/tinfo/init_keytry.c index 1669c641..ef20dfb1 100644 --- a/ncurses/tinfo/init_keytry.c +++ b/ncurses/tinfo/init_keytry.c @@ -1,5 +1,5 @@ /**************************************************************************** - * Copyright 2020 Thomas E. Dickey * + * Copyright 2020,2023 Thomas E. Dickey * * Copyright 1999-2010,2016 Free Software Foundation, Inc. * * * * Permission is hereby granted, free of charge, to any person obtaining a * @@ -30,7 +30,7 @@ #include #include /* struct tinfo_fkeys */ -MODULE_ID("$Id: init_keytry.c,v 1.19 2020/02/02 23:34:34 tom Exp $") +MODULE_ID("$Id: init_keytry.c,v 1.20 2023/09/16 12:55:01 tom Exp $") /* ** _nc_init_keytry() @@ -67,6 +67,8 @@ _nc_tinfo_fkeysf(void) NCURSES_EXPORT(void) _nc_init_keytry(SCREEN *sp) { + T(("_nc_init_keytry(%p)", (void *) sp)); + /* The sp->_keytry value is initialized in newterm(), where the sp * structure is created, because we can not tell where keypad() or * mouse_activate() (which will call keyok()) are first called. @@ -95,7 +97,7 @@ _nc_init_keytry(SCREEN *sp) char *value = tp->Strings[n]; if (name != 0 && *name == 'k' - && value != 0 + && VALID_STRING(value) && NCURSES_SP_NAME(key_defined) (NCURSES_SP_ARGx value) == 0) { (void) _nc_add_to_try(&(sp->_keytry), diff --git a/ncurses/tinfo/lib_napms.c b/ncurses/tinfo/lib_napms.c index 3a9fc316..1b89a54c 100644 --- a/ncurses/tinfo/lib_napms.c +++ b/ncurses/tinfo/lib_napms.c @@ -1,5 +1,5 @@ /**************************************************************************** - * Copyright 2020 Thomas E. Dickey * + * Copyright 2020,2023 Thomas E. Dickey * * Copyright 1998-2014,2017 Free Software Foundation, Inc. * * * * Permission is hereby granted, free of charge, to any person obtaining a * @@ -52,13 +52,16 @@ #endif #endif -MODULE_ID("$Id: lib_napms.c,v 1.27 2020/08/15 19:45:23 tom Exp $") +MODULE_ID("$Id: lib_napms.c,v 1.28 2023/09/16 16:09:33 tom Exp $") NCURSES_EXPORT(int) NCURSES_SP_NAME(napms) (NCURSES_SP_DCLx int ms) { T((T_CALLED("napms(%d)"), ms)); + if (ms > MAX_DELAY_MSECS) + ms = MAX_DELAY_MSECS; + #ifdef USE_TERM_DRIVER CallDriver_1(SP_PARM, td_nap, ms); #else /* !USE_TERM_DRIVER */ diff --git a/ncurses/tinfo/lib_setup.c b/ncurses/tinfo/lib_setup.c index ed93378c..d0d216dc 100644 --- a/ncurses/tinfo/lib_setup.c +++ b/ncurses/tinfo/lib_setup.c @@ -49,7 +49,7 @@ #include #endif -MODULE_ID("$Id: lib_setup.c,v 1.221 2023/07/22 20:13:04 tom Exp $") +MODULE_ID("$Id: lib_setup.c,v 1.222 2023/09/16 12:29:28 tom Exp $") /**************************************************************************** * @@ -503,6 +503,7 @@ _nc_setup_tinfo(const char *const tn, TERMTYPE2 *const tp) */ if (status == TGETENT_YES) { unsigned n; + T(("_nc_setup_tinfo - resetting invalid booleans/strings")); for_each_boolean(n, tp) { if (!VALID_BOOLEAN(tp->Booleans[n])) tp->Booleans[n] = FALSE; @@ -517,9 +518,9 @@ _nc_setup_tinfo(const char *const tn, TERMTYPE2 *const tp) #endif /* -** Take the real command character out of the CC environment variable -** and substitute it in for the prototype given in 'command_character'. -*/ + * Take the real command character out of the CC environment variable + * and substitute it in for the prototype given in 'command_character'. + */ void _nc_tinfo_cmdch(TERMINAL *termp, int proto) { @@ -535,9 +536,12 @@ _nc_tinfo_cmdch(TERMINAL *termp, int proto) char CC = *tmp; for_each_string(i, &(termp->type)) { - for (tmp = termp->type.Strings[i]; tmp && *tmp; tmp++) { - if (UChar(*tmp) == proto) - *tmp = CC; + tmp = termp->type.Strings[i]; + if (VALID_STRING(tmp)) { + for (; *tmp; ++tmp) { + if (UChar(*tmp) == proto) + *tmp = CC; + } } } } @@ -822,7 +826,7 @@ TINFO_SETUP_TERM(TERMINAL **tp, set_curterm(termp); - if (command_character) + if (VALID_STRING(command_character)) _nc_tinfo_cmdch(termp, UChar(*command_character)); /* diff --git a/ncurses/tinfo/lib_tparm.c b/ncurses/tinfo/lib_tparm.c index 724009cf..1353eb3f 100644 --- a/ncurses/tinfo/lib_tparm.c +++ b/ncurses/tinfo/lib_tparm.c @@ -53,7 +53,7 @@ #include #include -MODULE_ID("$Id: lib_tparm.c,v 1.151 2023/07/01 14:09:18 tom Exp $") +MODULE_ID("$Id: lib_tparm.c,v 1.152 2023/09/16 16:30:27 tom Exp $") /* * char * @@ -647,7 +647,7 @@ tparm_setup(TERMINAL *term, const char *string, TPARM_DATA *result) result->num_parsed = NUM_PARM; if (result->num_popped > NUM_PARM) result->num_popped = NUM_PARM; - result->num_actual = max(result->num_popped, result->num_parsed); + result->num_actual = Max(result->num_popped, result->num_parsed); for (n = 0; n < result->num_actual; ++n) { if (result->p_is_s[n]) diff --git a/ncurses/tinfo/lib_tputs.c b/ncurses/tinfo/lib_tputs.c index 7aa30f5f..f834532c 100644 --- a/ncurses/tinfo/lib_tputs.c +++ b/ncurses/tinfo/lib_tputs.c @@ -52,7 +52,7 @@ #include /* ospeed */ #include -MODULE_ID("$Id: lib_tputs.c,v 1.110 2023/04/22 15:12:57 tom Exp $") +MODULE_ID("$Id: lib_tputs.c,v 1.111 2023/09/16 16:05:15 tom Exp $") NCURSES_EXPORT_VAR(char) PC = 0; /* used by termcap library */ NCURSES_EXPORT_VAR(NCURSES_OSPEED) ospeed = 0; /* used by termcap library */ @@ -89,6 +89,9 @@ NCURSES_SP_NAME(delay_output) (NCURSES_SP_DCLx int ms) { T((T_CALLED("delay_output(%p,%d)"), (void *) SP_PARM, ms)); + if (ms > MAX_DELAY_MSECS) + ms = MAX_DELAY_MSECS; + if (!HasTInfoTerminal(SP_PARM)) returnCode(ERR); diff --git a/ncurses/tinfo/read_entry.c b/ncurses/tinfo/read_entry.c index 3591a508..b0f360ec 100644 --- a/ncurses/tinfo/read_entry.c +++ b/ncurses/tinfo/read_entry.c @@ -42,7 +42,7 @@ #include -MODULE_ID("$Id: read_entry.c,v 1.170 2023/06/24 18:09:05 tom Exp $") +MODULE_ID("$Id: read_entry.c,v 1.171 2023/09/16 16:30:34 tom Exp $") #define MyNumber(n) (short) LOW_MSB(n) @@ -351,7 +351,7 @@ _nc_read_termtype(TERMTYPE2 *ptr, char *buffer, int limit) } /* grab the name (a null-terminated string) */ - want = min(MAX_NAME_SIZE, (unsigned) name_size); + want = Min(MAX_NAME_SIZE, (unsigned) name_size); ptr->str_table = string_table; ptr->term_names = string_table; if ((have = (unsigned) Read(ptr->term_names, want)) != want) { @@ -364,7 +364,7 @@ _nc_read_termtype(TERMTYPE2 *ptr, char *buffer, int limit) offset = (int) (have - MAX_NAME_SIZE); /* grab the booleans */ - TYPE_CALLOC(NCURSES_SBOOL, max(BOOLCOUNT, bool_count), ptr->Booleans); + TYPE_CALLOC(NCURSES_SBOOL, Max(BOOLCOUNT, bool_count), ptr->Booleans); if (Read(ptr->Booleans, (unsigned) bool_count) < bool_count) { returnDB(TGETENT_NO); } @@ -378,13 +378,13 @@ _nc_read_termtype(TERMTYPE2 *ptr, char *buffer, int limit) even_boundary(name_size + bool_count); /* grab the numbers */ - TYPE_CALLOC(NCURSES_INT2, max(NUMCOUNT, num_count), ptr->Numbers); + TYPE_CALLOC(NCURSES_INT2, Max(NUMCOUNT, num_count), ptr->Numbers); if (!read_numbers(buf, num_count)) { returnDB(TGETENT_NO); } convert_numbers(buf, ptr->Numbers, num_count); - TYPE_CALLOC(char *, max(STRCOUNT, str_count), ptr->Strings); + TYPE_CALLOC(char *, Max(STRCOUNT, str_count), ptr->Strings); if (str_count) { /* grab the string offsets */ diff --git a/ncurses/tinfo/tinfo_driver.c b/ncurses/tinfo/tinfo_driver.c index eb4ecb3d..fd993b82 100644 --- a/ncurses/tinfo/tinfo_driver.c +++ b/ncurses/tinfo/tinfo_driver.c @@ -1,5 +1,5 @@ /**************************************************************************** - * Copyright 2018-2021,2022 Thomas E. Dickey * + * Copyright 2018-2022,2023 Thomas E. Dickey * * Copyright 2008-2016,2017 Free Software Foundation, Inc. * * * * Permission is hereby granted, free of charge, to any person obtaining a * @@ -52,7 +52,7 @@ # endif #endif -MODULE_ID("$Id: tinfo_driver.c,v 1.73 2022/08/13 14:36:43 tom Exp $") +MODULE_ID("$Id: tinfo_driver.c,v 1.74 2023/09/16 10:44:33 tom Exp $") /* * SCO defines TIOCGSIZE and the corresponding struct. Other systems (SunOS, @@ -206,8 +206,8 @@ drv_CanHandle(TERMINAL_CONTROL_BLOCK * TCB, const char *tname, int *errret) save_ttytype(termp); #endif - if (command_character) - _nc_tinfo_cmdch(termp, *command_character); + if (VALID_STRING(command_character)) + _nc_tinfo_cmdch(termp, UChar(*command_character)); /* * If an application calls setupterm() rather than initscr() or diff --git a/ncurses/tinfo/write_entry.c b/ncurses/tinfo/write_entry.c index 586b1dde..f05b4079 100644 --- a/ncurses/tinfo/write_entry.c +++ b/ncurses/tinfo/write_entry.c @@ -42,7 +42,7 @@ #include -MODULE_ID("$Id: write_entry.c,v 1.130 2023/07/08 14:00:24 tom Exp $") +MODULE_ID("$Id: write_entry.c,v 1.131 2023/09/16 16:28:36 tom Exp $") #if 1 #define TRACE_OUT(p) DEBUG(2, p) @@ -790,7 +790,8 @@ _nc_write_object(TERMTYPE2 *tp, char *buffer, unsigned *offset, unsigned limit) #else LITTLE_ENDIAN(buf, MAGIC); #endif - LITTLE_ENDIAN(buf + 2, min(namelen, MAX_NAME_SIZE + 1)); + namelen = Min(namelen, MAX_NAME_SIZE + 1); + LITTLE_ENDIAN(buf + 2, namelen); LITTLE_ENDIAN(buf + 4, boolmax); LITTLE_ENDIAN(buf + 6, nummax); LITTLE_ENDIAN(buf + 8, strmax); diff --git a/ncurses/tty/hashmap.c b/ncurses/tty/hashmap.c index 2ddfaaa2..e50b6384 100644 --- a/ncurses/tty/hashmap.c +++ b/ncurses/tty/hashmap.c @@ -74,7 +74,7 @@ AUTHOR #define CUR SP_TERMTYPE #endif -MODULE_ID("$Id: hashmap.c,v 1.70 2023/06/25 17:16:01 tom Exp $") +MODULE_ID("$Id: hashmap.c,v 1.71 2023/09/16 16:28:53 tom Exp $") #ifdef HASHDEBUG @@ -406,7 +406,7 @@ NCURSES_SP_NAME(_nc_hash_map) (NCURSES_SP_DCL0) && OLDNUM(SP_PARM, i) - i == shift) i++; size = i - start; - if (size < 3 || size + min(size / 8, 2) < abs(shift)) { + if (size < 3 || size + Min(size / 8, 2) < abs(shift)) { while (start < i) { OLDNUM(SP_PARM, start) = _NEWINDEX; start++; diff --git a/ncurses/tty/lib_mvcur.c b/ncurses/tty/lib_mvcur.c index aa3a67c5..8fad93c7 100644 --- a/ncurses/tty/lib_mvcur.c +++ b/ncurses/tty/lib_mvcur.c @@ -160,7 +160,7 @@ #define CUR SP_TERMTYPE #endif -MODULE_ID("$Id: lib_mvcur.c,v 1.158 2023/06/24 17:34:43 tom Exp $") +MODULE_ID("$Id: lib_mvcur.c,v 1.161 2023/09/16 16:29:02 tom Exp $") #define WANT_CHAR(sp, y, x) NewScreen(sp)->_line[y].text[x] /* desired state */ @@ -232,14 +232,33 @@ NCURSES_SP_NAME(_nc_msec_cost) (NCURSES_SP_DCLx const char *const cap, int affcn /* extract padding, either mandatory or required */ if (cp[0] == '$' && cp[1] == '<' && strchr(cp, '>')) { float number = 0.0; + int state = 0; for (cp += 2; *cp != '>'; cp++) { - if (isdigit(UChar(*cp))) - number = number * 10 + (float) (*cp - '0'); - else if (*cp == '*') - number *= (float) affcnt; - else if (*cp == '.' && (*++cp != '>') && isdigit(UChar(*cp))) - number += (float) ((*cp - '0') / 10.0); + if (isdigit(UChar(*cp))) { + switch (state) { + case 0: + number = number * 10 + (float) (*cp - '0'); + break; + case 2: + number += (float) ((*cp - '0') / 10.0); + ++state; + break; + } + } else if (*cp == '*') { + /* padding is always a suffix */ + if (state < 4) { + number *= (float) affcnt; + state = 4; + } + } else if (*cp == '.') { + /* a single decimal point is allowed */ + state = (state == 0) ? 2 : 3; + } + if (number > MAX_DELAY_MSECS) { + number = MAX_DELAY_MSECS; + break; + } } #if NCURSES_NO_PADDING @@ -432,8 +451,8 @@ NCURSES_SP_NAME(_nc_mvcur_init) (NCURSES_SP_DCL0) 1); SP_PARM->_hpa_ch_cost = NormalizedCost(TIPARM_1(column_address, 23), 1); SP_PARM->_cuf_ch_cost = NormalizedCost(TIPARM_1(parm_right_cursor, 23), 1); - SP_PARM->_inline_cost = min(SP_PARM->_cup_ch_cost, - min(SP_PARM->_hpa_ch_cost, + SP_PARM->_inline_cost = Min(SP_PARM->_cup_ch_cost, + Min(SP_PARM->_hpa_ch_cost, SP_PARM->_cuf_ch_cost)); /* diff --git a/ncurses/tty/lib_twait.c b/ncurses/tty/lib_twait.c index 407a7203..6fa73eed 100644 --- a/ncurses/tty/lib_twait.c +++ b/ncurses/tty/lib_twait.c @@ -76,7 +76,7 @@ #endif #undef CUR -MODULE_ID("$Id: lib_twait.c,v 1.80 2023/03/04 23:47:00 tom Exp $") +MODULE_ID("$Id: lib_twait.c,v 1.81 2023/09/16 16:30:40 tom Exp $") /* * Returns an elapsed time, in milliseconds (if possible). @@ -360,7 +360,7 @@ _nc_timed_wait(SCREEN *sp MAYBE_UNUSED, if ((mode & TW_MOUSE) && (fd = sp->_mouse_fd) >= 0) { FD_SET(fd, &set); - count = max(fd, count) + 1; + count = Max(fd, count) + 1; } #ifdef NCURSES_WGETCH_EVENTS if ((mode & TW_EVENT) && evl) { @@ -370,7 +370,7 @@ _nc_timed_wait(SCREEN *sp MAYBE_UNUSED, if (ev->type == _NC_EVENT_FILE && (ev->data.fev.flags & _NC_EVENT_FILE_READABLE)) { FD_SET(ev->data.fev.fd, &set); - count = max(ev->data.fev.fd + 1, count); + count = Max(ev->data.fev.fd + 1, count); } } } diff --git a/ncurses/tty/tty_update.c b/ncurses/tty/tty_update.c index 80815244..066b7fce 100644 --- a/ncurses/tty/tty_update.c +++ b/ncurses/tty/tty_update.c @@ -1,5 +1,5 @@ /**************************************************************************** - * Copyright 2018-2021,2022 Thomas E. Dickey * + * Copyright 2018-2022,2023 Thomas E. Dickey * * Copyright 1998-2016,2017 Free Software Foundation, Inc. * * * * Permission is hereby granted, free of charge, to any person obtaining a * @@ -85,7 +85,7 @@ #include -MODULE_ID("$Id: tty_update.c,v 1.314 2022/07/23 22:12:59 tom Exp $") +MODULE_ID("$Id: tty_update.c,v 1.315 2023/09/16 16:38:41 tom Exp $") /* * This define controls the line-breakout optimization. Every once in a @@ -1004,7 +1004,7 @@ TINFO_DOUPDATE(NCURSES_SP_DCL0) if (check_pending(NCURSES_SP_ARG)) goto cleanup; - nonempty = min(screen_lines(SP_PARM), NewScreen(SP_PARM)->_maxy + 1); + nonempty = Min(screen_lines(SP_PARM), NewScreen(SP_PARM)->_maxy + 1); if (SP_PARM->_scrolling) { NCURSES_SP_NAME(_nc_scroll_optimize) (NCURSES_SP_ARG); @@ -1134,7 +1134,7 @@ ClrUpdate(NCURSES_SP_DCL0) if (0 != SP_PARM) { int i; NCURSES_CH_T blank = ClrBlank(NCURSES_SP_ARGx StdScreen(SP_PARM)); - int nonempty = min(screen_lines(SP_PARM), + int nonempty = Min(screen_lines(SP_PARM), NewScreen(SP_PARM)->_maxy + 1); ClearScreen(NCURSES_SP_ARGx blank); @@ -1233,7 +1233,7 @@ static int ClrBottom(NCURSES_SP_DCLx int total) { int top = total; - int last = min(screen_columns(SP_PARM), NewScreen(SP_PARM)->_maxx + 1); + int last = Min(screen_columns(SP_PARM), NewScreen(SP_PARM)->_maxx + 1); NCURSES_CH_T blank = NewScreen(SP_PARM)->_line[total - 1].text[last - 1]; if (clr_eos && can_clear_with(NCURSES_SP_ARGx CHREF(blank))) { @@ -1293,7 +1293,7 @@ ClrBottom(NCURSES_SP_DCLx int total) ** nLastChar = position of last different character in new line ** ** move to firstChar -** overwrite chars up to min(oLastChar, nLastChar) +** overwrite chars up to Min(oLastChar, nLastChar) ** if oLastChar < nLastChar ** insert newLine[oLastChar+1..nLastChar] ** else @@ -1531,7 +1531,7 @@ TransformLine(NCURSES_SP_DCLx int const lineno) } ClrToEOL(NCURSES_SP_ARGx blank, FALSE); } else { - n = max(nLastChar, oLastChar); + n = Max(nLastChar, oLastChar); PutRange(NCURSES_SP_ARGx oldLine, newLine, @@ -1556,7 +1556,7 @@ TransformLine(NCURSES_SP_DCLx int const lineno) break; } - n = min(oLastChar, nLastChar); + n = Min(oLastChar, nLastChar); if (n >= firstChar) { GoTo(NCURSES_SP_ARGx lineno, firstChar); PutRange(NCURSES_SP_ARGx @@ -1568,7 +1568,7 @@ TransformLine(NCURSES_SP_DCLx int const lineno) } if (oLastChar < nLastChar) { - int m = max(nLastNonblank, oLastNonblank); + int m = Max(nLastNonblank, oLastNonblank); #if USE_WIDEC_SUPPORT if (n) { while (isWidecExt(newLine[n + 1]) && n) { diff --git a/ncurses/win32con/win32_driver.c b/ncurses/win32con/win32_driver.c index 67b81625..0a43588b 100644 --- a/ncurses/win32con/win32_driver.c +++ b/ncurses/win32con/win32_driver.c @@ -48,7 +48,7 @@ #define CUR TerminalType(my_term). -MODULE_ID("$Id: win32_driver.c,v 1.3 2023/03/25 14:08:36 tom Exp $") +MODULE_ID("$Id: win32_driver.c,v 1.4 2023/09/16 16:29:24 tom Exp $") #define WINMAGIC NCDRV_MAGIC(NCDRV_WINCONSOLE) #define EXP_OPTIMIZE 0 @@ -393,7 +393,7 @@ wcon_doupdate(TERMINAL_CONTROL_BLOCK * TCB) Width = screen_columns(sp); Height = screen_lines(sp); - nonempty = min(Height, NewScreen(sp)->_maxy + 1); + nonempty = Min(Height, NewScreen(sp)->_maxy + 1); T(("... %dx%d clear cur:%d new:%d", Height, Width, diff --git a/ncurses/win32con/win_driver.c b/ncurses/win32con/win_driver.c index 2945d8dc..2425b3a4 100644 --- a/ncurses/win32con/win_driver.c +++ b/ncurses/win32con/win_driver.c @@ -57,7 +57,7 @@ #define CONTROL_PRESSED (LEFT_CTRL_PRESSED | RIGHT_CTRL_PRESSED) -MODULE_ID("$Id: win_driver.c,v 1.73 2023/08/05 19:02:24 tom Exp $") +MODULE_ID("$Id: win_driver.c,v 1.74 2023/09/16 16:27:44 tom Exp $") #define TypeAlloca(type,count) (type*) _alloca(sizeof(type) * (size_t) (count)) @@ -488,7 +488,7 @@ wcon_doupdate(TERMINAL_CONTROL_BLOCK * TCB) Width = screen_columns(sp); Height = screen_lines(sp); - nonempty = min(Height, NewScreen(sp)->_maxy + 1); + nonempty = Min(Height, NewScreen(sp)->_maxy + 1); T(("... %dx%d clear cur:%d new:%d", Height, Width, diff --git a/package/debian-mingw/changelog b/package/debian-mingw/changelog index 9c61e9bf..5e8d4e6e 100644 --- a/package/debian-mingw/changelog +++ b/package/debian-mingw/changelog @@ -1,8 +1,8 @@ -ncurses6 (6.4+20230909) unstable; urgency=low +ncurses6 (6.4+20230917) unstable; urgency=low * latest weekly patch - -- Thomas E. Dickey Sat, 09 Sep 2023 08:21:39 -0400 + -- Thomas E. Dickey Sun, 17 Sep 2023 04:35:40 -0400 ncurses6 (5.9+20131005) unstable; urgency=low diff --git a/package/debian-mingw64/changelog b/package/debian-mingw64/changelog index 9c61e9bf..5e8d4e6e 100644 --- a/package/debian-mingw64/changelog +++ b/package/debian-mingw64/changelog @@ -1,8 +1,8 @@ -ncurses6 (6.4+20230909) unstable; urgency=low +ncurses6 (6.4+20230917) unstable; urgency=low * latest weekly patch - -- Thomas E. Dickey Sat, 09 Sep 2023 08:21:39 -0400 + -- Thomas E. Dickey Sun, 17 Sep 2023 04:35:40 -0400 ncurses6 (5.9+20131005) unstable; urgency=low diff --git a/package/debian/changelog b/package/debian/changelog index daf3cf75..ae6d9582 100644 --- a/package/debian/changelog +++ b/package/debian/changelog @@ -1,8 +1,8 @@ -ncurses6 (6.4+20230909) unstable; urgency=low +ncurses6 (6.4+20230917) unstable; urgency=low * latest weekly patch - -- Thomas E. Dickey Sat, 09 Sep 2023 08:21:39 -0400 + -- Thomas E. Dickey Sun, 17 Sep 2023 04:35:40 -0400 ncurses6 (5.9+20120608) unstable; urgency=low diff --git a/package/mingw-ncurses.nsi b/package/mingw-ncurses.nsi index 05be5485..3127d319 100644 --- a/package/mingw-ncurses.nsi +++ b/package/mingw-ncurses.nsi @@ -1,4 +1,4 @@ -; $Id: mingw-ncurses.nsi,v 1.603 2023/09/09 12:21:39 tom Exp $ +; $Id: mingw-ncurses.nsi,v 1.605 2023/09/17 08:35:40 tom Exp $ ; TODO add examples ; TODO bump ABI to 6 @@ -10,7 +10,7 @@ !define VERSION_MAJOR "6" !define VERSION_MINOR "4" !define VERSION_YYYY "2023" -!define VERSION_MMDD "0909" +!define VERSION_MMDD "0917" !define VERSION_PATCH ${VERSION_YYYY}${VERSION_MMDD} !define MY_ABI "5" diff --git a/package/mingw-ncurses.spec b/package/mingw-ncurses.spec index e108cf6f..a9341799 100644 --- a/package/mingw-ncurses.spec +++ b/package/mingw-ncurses.spec @@ -3,7 +3,7 @@ Summary: shared libraries for terminal handling Name: mingw32-ncurses6 Version: 6.4 -Release: 20230909 +Release: 20230917 License: X11 Group: Development/Libraries URL: https://invisible-island.net/ncurses/ diff --git a/package/ncurses.spec b/package/ncurses.spec index b32c8999..9aafe162 100644 --- a/package/ncurses.spec +++ b/package/ncurses.spec @@ -1,7 +1,7 @@ Summary: shared libraries for terminal handling Name: ncurses6 Version: 6.4 -Release: 20230909 +Release: 20230917 License: X11 Group: Development/Libraries URL: https://invisible-island.net/ncurses/ diff --git a/package/ncursest.spec b/package/ncursest.spec index e241a4d7..824e43cd 100644 --- a/package/ncursest.spec +++ b/package/ncursest.spec @@ -1,7 +1,7 @@ Summary: Curses library with POSIX thread support. Name: ncursest6 Version: 6.4 -Release: 20230909 +Release: 20230917 License: X11 Group: Development/Libraries Source: ncurses-%{version}-%{release}.tgz diff --git a/progs/doit b/progs/doit new file mode 100644 index 00000000..81652c4b --- /dev/null +++ b/progs/doit @@ -0,0 +1,11 @@ +#!/bin/sh +cd ../ncurses +make || exit +cd ../progs +make || exit +export TERMINFO=/tmp/FOO +rm -rf $TERMINFO +mkdir -p $TERMINFO +rm -f trace +shlib ./tic -v2 -x /var/mail/long_name.ti +shlib ./infocmp -x xy

ADACURSES 1 2023-08-19 ncurses 6.4 User commands

ADACURSES 1 2023-09-17 ncurses 6.4 User commands

captoinfo 1m 2023-09-09 ncurses 6.4 User commands

captoinfo 1m 2023-09-16 ncurses 6.4 User commands

clear 1 2023-09-09 ncurses 6.4 User commands

clear 1 2023-09-16 ncurses 6.4 User commands

curs_add_wch 3x 2023-08-19 ncurses 6.4 Library calls

curs_add_wch 3x 2023-09-16 ncurses 6.4 Library calls

curs_add_wchstr 3x 2022-02-12 ncurses 6.4 Library calls

curs_add_wchstr 3x 2023-09-16 ncurses 6.4 Library calls

curs_addch 3x 2023-08-19 ncurses 6.4 Library calls

curs_addch 3x 2023-09-16 ncurses 6.4 Library calls

curs_addchstr 3x 2022-02-12 ncurses 6.4 Library calls

curs_addchstr 3x 2023-09-16 ncurses 6.4 Library calls

curs_addstr 3x 2023-03-11 ncurses 6.4 Library calls

curs_addstr 3x 2023-09-16 ncurses 6.4 Library calls

curs_addwstr 3x 2023-07-15 ncurses 6.4 Library calls

curs_addwstr 3x 2023-09-16 ncurses 6.4 Library calls

curs_attr 3x 2023-09-09 ncurses 6.4 Library calls

curs_attr 3x 2023-09-16 ncurses 6.4 Library calls

curs_beep 3x 2021-12-25 ncurses 6.4 Library calls

curs_beep 3x 2023-09-16 ncurses 6.4 Library calls

curs_bkgd 3x 2023-07-01 ncurses 6.4 Library calls

curs_bkgd 3x 2023-09-16 ncurses 6.4 Library calls

curs_bkgrnd 3x 2023-08-12 ncurses 6.4 Library calls

curs_bkgrnd 3x 2023-09-16 ncurses 6.4 Library calls

curs_border 3x 2023-07-01 ncurses 6.4 Library calls

curs_border 3x 2023-09-16 ncurses 6.4 Library calls

curs_border_set 3x 2023-07-01 ncurses 6.4 Library calls

curs_border_set 3x 2023-09-16 ncurses 6.4 Library calls

curs_clear 3x 2023-07-01 ncurses 6.4 Library calls

curs_clear 3x 2023-09-16 ncurses 6.4 Library calls

curs_color 3x 2023-07-01 ncurses 6.4 Library calls

curs_color 3x 2023-09-16 ncurses 6.4 Library calls

curs_delch 3x 2023-07-01 ncurses 6.4 Library calls

curs_delch 3x 2023-09-16 ncurses 6.4 Library calls

curs_deleteln 3x 2023-07-01 ncurses 6.4 Library calls

curs_deleteln 3x 2023-09-16 ncurses 6.4 Library calls

curs_extend 3x 2023-07-01 ncurses 6.4 Library calls

curs_extend 3x 2023-09-16 ncurses 6.4 Library calls

curs_get_wch 3x 2022-02-12 ncurses 6.4 Library calls

curs_get_wch 3x 2023-09-16 ncurses 6.4 Library calls