X-Git-Url: http://ncurses.scripts.mit.edu/?p=ncurses.git;a=blobdiff_plain;f=doc%2Fhtml%2Fman%2Fcurs_terminfo.3x.html;h=2477c6bf1faed4142e4f9b1cec6d01af77d1f64e;hp=dd85e353ed2b8ec95cd6d86da941a70556ad6177;hb=29a36e53e1f77a0c3672f2e267d573823d6a9a60;hpb=b0b1980be11bba618d84beb8b30ac94e2c820602 diff --git a/doc/html/man/curs_terminfo.3x.html b/doc/html/man/curs_terminfo.3x.html index dd85e353..2477c6bf 100644 --- a/doc/html/man/curs_terminfo.3x.html +++ b/doc/html/man/curs_terminfo.3x.html @@ -1,7 +1,6 @@ - +
+ +- curs_terminfo(3x) curs_terminfo(3x) --
+
del_curterm, mvcur, putp, restartterm, set_curterm, setterm, setupterm, tigetflag, tigetnum, tigetstr, tiparm, tparm, tputs, vid_attr, vid_puts, vidattr, vidputs - curses interfaces to terminfo database --
+
#include <curses.h> #include <term.h> @@ -82,15 +80,15 @@ char *tiparm(const char *str, ...); --
+
These low-level routines must be called by programs that have to deal directly with the terminfo database to handle certain terminal capabilities, such as programming func- tion keys. For all other functionality, curses routines are more suitable and their use is recommended. - Initialization + +
Initially, setupterm should be called. Note that se- tupterm is automatically called by initscr and newterm. This defines the set of terminal-dependent variables @@ -178,7 +176,8 @@ setterm routine is provided for BSD compatibility, and is not recommended for new programs. - 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 @@ -214,7 +213,8 @@ tty state bits, calls setupterm, and then restores the bits. - Formatting Output + +
The tparm routine instantiates the string str with parame- ters pi. A pointer is returned to the result of str with the parameters applied. @@ -223,7 +223,8 @@ rather than a fixed-parameter list. Its numeric parame- ters are integers (int) rather than longs. - Output Functions + +
The tputs routine applies padding information to the string str and outputs it. The str must be a terminfo string variable or the return value from tparm, tgetstr, @@ -257,7 +258,8 @@ takes effect immediately (rather than at the next re- fresh). - Terminal Capability Functions + +
The tigetflag, tigetnum and tigetstr routines return the value of the capability corresponding to the terminfo cap- name passed to them, such as xenl. The capname for each @@ -288,7 +290,8 @@ 0 if it is canceled or absent from the terminal de- scription. - Terminal Capability Names + +
These null-terminated arrays contain the short terminfo names ("codes"), the termcap names, and the long terminfo names ("fnames") for each of the predefined terminfo vari- @@ -300,8 +303,7 @@ char *strnames[], *strcodes[], *strfnames[] --
+
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 @@ -335,8 +337,7 @@ the output function putc. --
+
X/Open notes that vidattr and vidputs may be macros. The function setterm is not described by X/Open and must @@ -361,7 +362,7 @@ passed to setupterm from initscr or newterm uses buffered I/O, and would write to the corresponding stream. In ad- dition to the limitation that the terminal was left in - block-buffered mode on exit (like SystemV curses), it was + 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 uses output buffers managed directly by ncurses. Some of the @@ -413,8 +414,7 @@ tic -x, are not stored in the arrays described here. --
+
curses(3x), curs_initscr(3x), curs_kernel(3x), curs_term- cap(3x), curs_variables(3x), term_variables(3x), putc(3), terminfo(5) @@ -423,7 +423,24 @@ curs_terminfo(3x)-