X-Git-Url: http://ncurses.scripts.mit.edu/?a=blobdiff_plain;f=doc%2Fhtml%2Fman%2Fncurses.3x.html;h=6a0f8f922df175ba82740ca9a15d871cbcf5e8d0;hb=5dbe81a41e3c75806996cd762b9e55dcc9edb835;hp=b175a43af4f7372f00747fc61c3443b2cd905718;hpb=6a530b46563470c2ca73579d1994a0c8e275dd98;p=ncurses.git diff --git a/doc/html/man/ncurses.3x.html b/doc/html/man/ncurses.3x.html index b175a43a..6a0f8f92 100644 --- a/doc/html/man/ncurses.3x.html +++ b/doc/html/man/ncurses.3x.html @@ -27,7 +27,7 @@ * sale, use or other dealings in this Software without prior written * * authorization. * **************************************************************************** - * @Id: ncurses.3x,v 1.120 2015/07/21 23:37:10 tom Exp @ + * @Id: ncurses.3x,v 1.124 2015/08/08 14:57:51 tom Exp @ --> @@ -46,24 +46,21 @@ - -
+
ncurses - CRT screen handling and optimization package --
+
#include <curses.h> --
+
The ncurses library routines give the user a terminal- independent method of updating character screens with rea- sonable optimization. This implementation is "new curses" (ncurses) and is the approved replacement for 4.4BSD clas- sic curses, which has been discontinued. This describes - ncurses version 6.0 (patch 20150725). + ncurses version 6.0 (patch 20160514). The ncurses library emulates the curses library of System V Release 4 UNIX, and XPG4 (X/Open Portability Guide) @@ -97,8 +94,7 @@ access to low-level terminal-manipulation routines. --
+
The library uses the locale which the calling program has initialized. That is normally done with setlocale: @@ -135,8 +131,7 @@ for doing this. [See terminfo(5) for further details.] --
+
The ncurses library permits manipulation of data struc- tures, called windows, which can be thought of as two- dimensional arrays of characters representing all or part @@ -182,8 +177,7 @@ <curses.h>, such as A_REVERSE, ACS_HLINE, and KEY_LEFT. --
+
If the environment variables LINES and COLUMNS are set, or if the program is executing in a window environment, line and column information in the environment will override @@ -224,8 +218,7 @@ curscr can be used in only a few routines. --
+
Many curses routines have two or more versions. The rou- tines prefixed with w require a window argument. The rou- tines prefixed with p require a pad argument. Those with- @@ -306,8 +299,7 @@ becomes wadd_wch. --
+
The following table lists each curses routine and the name of the manual page on which it is described. Routines flagged with `*' are ncurses-specific, not described by @@ -459,7 +451,9 @@ is_nodelay curs_opaque(3x)* is_notimeout curs_opaque(3x)* + is_pad curs_opaque(3x)* is_scrollok curs_opaque(3x)* + is_subwin curs_opaque(3x)* is_syncok curs_opaque(3x)* is_term_resized resizeterm(3x)* is_wintouched curs_touch(3x) @@ -522,9 +516,9 @@ mvscanw curs_scanw(3x) mvvline curs_border(3x) mvvline_set curs_border_set(3x) + mvwadd_wch curs_add_wch(3x) mvwadd_wchnstr curs_add_wchstr(3x) - mvwadd_wchstr curs_add_wchstr(3x) mvwaddch curs_addch(3x) mvwaddchnstr curs_addchstr(3x) @@ -589,11 +583,12 @@ qiflush curs_inopts(3x) raw curs_inopts(3x) redrawwin curs_refresh(3x) + refresh curs_refresh(3x) reset_prog_mode curs_kernel(3x) - reset_shell_mode curs_kernel(3x) resetty curs_kernel(3x) + resize_term resizeterm(3x)* resizeterm resizeterm(3x)* restartterm curs_terminfo(3x) ripoffline curs_kernel(3x) @@ -646,6 +641,7 @@ tigetflag curs_terminfo(3x) tigetnum curs_terminfo(3x) tigetstr curs_terminfo(3x) + tiparm curs_terminfo(3x)* timeout curs_inopts(3x) touchline curs_touch(3x) touchwin curs_touch(3x) @@ -654,11 +650,11 @@ tputs curs_terminfo(3x) trace curs_trace(3x)* typeahead curs_inopts(3x) + unctrl curs_util(3x) unget_wch curs_get_wch(3x) ungetch curs_getch(3x) ungetmouse curs_mouse(3x)* - untouchwin curs_touch(3x) use_default_colors default_colors(3x)* use_env curs_util(3x) @@ -714,10 +710,14 @@ wget_wstr curs_get_wstr(3x) wgetbkgrnd curs_bkgrnd(3x) wgetch curs_getch(3x) + wgetdelay curs_opaque(3x)* wgetn_wstr curs_get_wstr(3x) wgetnstr curs_getstr(3x) + wgetparent curs_opaque(3x)* + wgetscrreg curs_opaque(3x)* wgetstr curs_getstr(3x) whline curs_border(3x) + whline_set curs_border_set(3x) win_wch curs_in_wch(3x) win_wchnstr curs_in_wchstr(3x) @@ -725,7 +725,6 @@ winch curs_inch(3x) winchnstr curs_inchstr(3x) winchstr curs_inchstr(3x) - winnstr curs_instr(3x) winnwstr curs_inwstr(3x) wins_nwstr curs_ins_wstr(3x) @@ -759,8 +758,7 @@ wvline_set curs_border_set(3x) --
+
Routines that return an integer return ERR upon failure and an integer value other than ERR upon successful com- pletion, unless otherwise noted in the routine descrip- @@ -778,8 +776,7 @@ Routines that return pointers return NULL on error. --
+
The following environment symbols are useful for customiz- ing the runtime behavior of the ncurses library. The most important ones have been already discussed in detail. @@ -795,8 +792,7 @@ it does not happen to be a single character. --
+
The debugging library checks this environment variable when the application has redirected output to a file. The variable's numeric value is used for the baudrate. If no @@ -805,8 +801,7 @@ costs that depend on baudrate. --
+
Specify the width of the screen in characters. Applica- tions running in a windowing environment usually are able to obtain the width of the window in which they are exe- @@ -837,8 +832,7 @@ system calls or the terminal database. --
+
Specifies the total time, in milliseconds, for which ncurses will await a character sequence, e.g., a function key. The default value, 1000 milliseconds, is enough for @@ -867,8 +861,7 @@ lems when compiling an application. --
+
Tells ncurses where your home directory is. That is where it may read and write auxiliary terminal descriptions: @@ -876,14 +869,12 @@ $HOME/.terminfo --
+
Like COLUMNS, specify the height of the screen in charac- ters. See COLUMNS for a detailed description. --
+
This applies only to the OS/2 EMX port. It specifies the order of buttons on the mouse. OS/2 numbers a 3-button mouse inconsistently from other platforms: @@ -897,8 +888,7 @@ or 321. If it is not specified, ncurses uses 132. --
+
Override the compiled-in assumption that the terminal's default colors are white-on-black (see default_col- ors(3x)). You may set the foreground and background color @@ -910,8 +900,7 @@ value is allowed. --
+
This applies only to the MinGW port of ncurses. The Console2 program's handling of the Microsoft Console @@ -923,8 +912,7 @@ same effect. --
+
This applies only to ncurses configured to use the GPM interface. @@ -938,8 +926,7 @@ attempt to open GPM if TERM contains "linux". --
+
Ncurses may use tabs as part of the cursor movement opti- mization. In some cases, your terminal driver may not handle these properly. Set this environment variable to @@ -952,8 +939,7 @@ environment variable. --
+
Most of the terminal descriptions in the terminfo database are written for real "hardware" terminals. Many people use terminal emulators which run in a windowing environ- @@ -980,8 +966,7 @@ part of special control sequences such as flash. --
+
This setting is obsolete. Before changes o started with 5.9 patch 20120825 and @@ -1011,8 +996,7 @@ level curses calls do not. --
+
During initialization, the ncurses library checks for spe- cial cases where VT100 line-drawing (and the corresponding alternate character set capabilities) described in the @@ -1048,8 +1032,7 @@ interface. --
+
During initialization, the ncurses debugging library checks the NCURSES_TRACE environment variable. If it is defined, to a numeric value, ncurses calls the trace func- @@ -1063,8 +1046,7 @@ See curs_trace(3x) for more information. --
+
Denotes your terminal type. Each terminal type is dis- tinct, though many are similar. @@ -1084,8 +1066,7 @@ match that setting. --
+
If the ncurses library has been configured with termcap support, ncurses will check for a terminal's description in termcap form if it is not available in the terminfo @@ -1099,8 +1080,7 @@ mation, e.g., /etc/termcap. --
+
Overrides the directory in which ncurses searches for your terminal description. This is the simplest, but not the only way to change the list of directories. The complete @@ -1128,8 +1108,7 @@ MINFO variable) --
+
Specifies a list of directories to search for terminal descriptions. The list is separated by colons (i.e., ":") on Unix, semicolons on OS/2 EMX. @@ -1148,8 +1127,7 @@ of a termcap file. --
+
If TERMCAP does not hold a file name then ncurses checks the TERMPATH environment variable. This is a list of filenames separated by spaces or colons (i.e., ":") on @@ -1166,8 +1144,7 @@ $TERMINFO, $TERMINFO_DIRS, $TERMPATH, as well as $HOME. --
+
Several different configurations are possible, depending on the configure script options used when building ncurses. There are a few main options whose effects are @@ -1248,23 +1225,20 @@ ing it is always in the debug library. --
+
/usr/share/tabset directory containing initialization files for the terminal capability database /usr/share/terminfo ter- minal capability database --
+
terminfo(5) and related pages whose names begin "curs_" for detailed routine descriptions. curs_variables(3x) --
+
The ncurses library can be compiled with an option (-DUSE_GETCAP) that falls back to the old-style /etc/term- cap file if the terminal setup code cannot find a terminfo @@ -1303,8 +1277,7 @@ device. See the curs_print(3x) manual page for details. --
+
The ncurses library is intended to be BASE-level confor- mant with XSI Curses. The EXTENDED XSI Curses functional- ity (including color support) is supported. @@ -1367,8 +1340,7 @@ package's portability correspondingly. --
+
The header file <curses.h> automatically includes the header files <stdio.h> and <unctrl.h>. @@ -1378,8 +1350,7 @@ ture of AT&T System V Release 3 curses. --
+
Zeyd M. Ben-Halim, Eric S. Raymond, Thomas E. Dickey. Based on pcurses by Pavel Curtis.