X-Git-Url: https://ncurses.scripts.mit.edu/?a=blobdiff_plain;f=Ada95%2Fhtml%2Fcurs_terminfo.3x.html;fp=Ada95%2Fhtml%2Fcurs_terminfo.3x.html;h=85d536f449f4c7b37b940aee2fb5310cf5466b33;hb=661078ddbde3ce0f3b06e95642fbb9b5fef7dca1;hp=e125d9975f3c65453bcddfee00868dd7e503ed07;hpb=3a9b6a3bf0269231bef7de74757a910dedd04e0c;p=ncurses.git
diff --git a/Ada95/html/curs_terminfo.3x.html b/Ada95/html/curs_terminfo.3x.html
index e125d997..85d536f4 100644
--- a/Ada95/html/curs_terminfo.3x.html
+++ b/Ada95/html/curs_terminfo.3x.html
@@ -19,8 +19,6 @@
int restartterm(const char *term, int fildes, int
*errret);
char *tparm(const char *str, ...);
- char *tparam(const char *str, char *buffer, int size,
- ...);
int tputs(const char *str, int affcnt, int (*putc)(int));
int putp(const char *str);
int vidputs(chtype attrs, int (*putc)(char));
@@ -33,96 +31,91 @@
DESCRIPTION
- These low-level routines must be called by programs that
+ 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
+ certain terminal capabilities, such as programming func-
+ tion keys. For all other functionality, curses routines
are more suitable and their use is recommended.
- Initially, setupterm should be called. Note that
- setupterm is automatically called by initscr and newterm.
+ Initially, setupterm should be called. Note that
+ setupterm is automatically called by initscr and newterm.
This defines the set of terminal-dependent variables
[listed in terminfo(5)]. The terminfo variables lines and
columns are initialized by setupterm as follows: If
- use_env(FALSE) has been called, values for lines and
+ use_env(FALSE) has been called, values for lines and
columns specified in terminfo are used. Otherwise, if the
- environment variables LINES and COLUMNS exist, their val-
+ environment variables LINES and COLUMNS exist, their val-
ues 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 values for lines and columns specified in
+ size is used. Otherwise, if the environment variables do
+ not exist, the values for lines and columns specified in
the terminfo database are used.
- The header files curses.h and term.h should be included
- (in this order) to get the definitions for these strings,
+ The header files curses.h and term.h should be included
+ (in this order) to get the definitions for these strings,
numbers, and flags. Parameterized strings should be
- passed through tparm to instantiate them. All terminfo
- the tty modes before exiting [see curs_kernel(3X)]. Pro-
- grams which use cursor addressing should output
- enter_ca_mode upon startup and should output exit_ca_mode
- before exiting. Programs desiring shell escapes should
+ passed through tparm to instantiate them. All terminfo
+ strings [including the output of tparm] should be printed
+ with tputs or putp. Call the reset_shell_mode to restore
+ enter_ca_mode upon startup and should output exit_ca_mode
+ before exiting. Programs desiring shell escapes should
call
- reset_shell_mode and output exit_ca_mode before the shell
- is called and should output enter_ca_mode and call
+ reset_shell_mode and output exit_ca_mode before the shell
+ is called and should output enter_ca_mode and call
reset_prog_mode after returning from the shell.
The setupterm routine reads in the terminfo database, ini-
tializing the terminfo structures, but does not set up the
output virtualization structures used by curses. The ter-
- minal type is the character string term; if term is null,
- the environment variable TERM is used. All output is to
- file descriptor fildes which is initialized for output.
- If errret is not null, then setupterm returns OK or ERR
- and stores a status value in the integer pointed to by
- errret. A status of 1 in errret is normal, 0 means that
- the terminal could not be found, and -1 means that the
- terminfo database could not be found. If errret is null,
- setupterm prints an error message upon finding an error
+ minal type is the character string term; if term is null,
+ the environment variable TERM is used. All output is to
+ file descriptor fildes which is initialized for output.
+ If errret is not null, then setupterm returns OK or ERR
+ and stores a status value in the integer pointed to by
+ errret. A status of 1 in errret is normal, 0 means that
+ the terminal could not be found, and -1 means that the
+ terminfo database could not be found. 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);,
- which uses all the defaults and sends the output to std-
+ which uses all the defaults and sends the output to std-
out.
- The setterm routine is being replaced by setupterm. The
+ The setterm routine is being replaced by setupterm. The
call:
setupterm(term, 1, (int *)0)
- provides the same functionality as setterm(term). The
- setterm routine is included here for BSD compatibility,
+ provides the same functionality as setterm(term). The
+ setterm routine is included here for BSD compatibility,
and is not recommended for new programs.
- The set_curterm routine sets the variable cur_term to
+ The set_curterm routine sets the variable cur_term to
nterm, and makes all of the terminfo boolean, numeric, and
- string variables use the values from nterm. It returns
+ 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
+ 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
+ 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
- and the input and output options are the same as when mem-
- ory was saved, but the terminal type and baud rate may be
- different. Accordingly, it saves various tty state bits,
- does a setupterm, and then restores the bits.
+ 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). It assumes that the windows
+ be different. Accordingly, it saves various tty state
+ bits, does a setupterm, and then restores the bits.
The tparm routine instantiates the string str with parame-
- ters pi. A pointer is returned to the result of str with
+ ters pi. A pointer is returned to the result of str with
the parameters applied.
- The tparam routine is included for compatibility with the
- GNU termcap implementation. It works like tparm but you
- specify a buffer and buffer size to be filled with the
- expanded string.
-
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,
@@ -161,12 +154,13 @@
The capname for each capability is given in the table col-
umn entitled capname code in the capabilities section of
+ terminfo(5).
+
+ char *boolnames, *boolcodes, *boolfnames
char *numnames, *numcodes, *numfnames
char *strnames, *strcodes, *strfnames
-
- These null-terminated arrays contain the capnames, the
termcap codes, and the full C names, for each of the ter-
minfo variables.
@@ -221,6 +215,12 @@
+
+
+
+
+
+