X-Git-Url: https://ncurses.scripts.mit.edu/?p=ncurses.git;a=blobdiff_plain;f=doc%2Fhtml%2Fman%2Fcurs_initscr.3x.html;h=0994519957fad414403f32f0f17572d3788ec269;hp=1b668b29744ec214314c2d829957c9631afea62c;hb=29a36e53e1f77a0c3672f2e267d573823d6a9a60;hpb=32f9f5f12cd9159261f9db228461049e8c770404 diff --git a/doc/html/man/curs_initscr.3x.html b/doc/html/man/curs_initscr.3x.html index 1b668b29..09945199 100644 --- a/doc/html/man/curs_initscr.3x.html +++ b/doc/html/man/curs_initscr.3x.html @@ -26,7 +26,7 @@ * sale, use or other dealings in this Software without prior written * * authorization. * **************************************************************************** - * @Id: curs_initscr.3x,v 1.23 2015/07/16 09:23:42 tom Exp @ + * @Id: curs_initscr.3x,v 1.24 2015/07/21 23:01:38 tom Exp @ --> @@ -45,29 +45,25 @@ - -
+
initscr, newterm, endwin, isendwin, set_term, delscreen - curses screen initialization and manipulation routines --
+
#include <curses.h> WINDOW *initscr(void); int endwin(void); bool isendwin(void); - SCREEN *newterm(char *type, FILE *outfd, FILE *infd); - SCREEN *set_term(SCREEN *new); - void delscreen(SCREEN* sp); + SCREEN *newterm(char *type, FILE *outfd, FILE *infd); + SCREEN *set_term(SCREEN *new); + void delscreen(SCREEN* sp); --
+
--
+
initscr is normally the first curses routine to call when initializing a program. A few special routines sometimes need to be called before it; these are slk_init, filter, @@ -82,8 +78,7 @@ stdscr. --
+
A program that outputs to more than one terminal should use the newterm routine for each terminal instead of initscr. A program that needs to inspect capabilities, so @@ -103,8 +98,7 @@ If the type parameter is NULL, $TERM will be used. --
+
The program must also call endwin for each terminal being used before exiting from curses. If newterm is called more than once for the same terminal, the first terminal @@ -125,15 +119,13 @@ es the program to resume visual mode. --
+
The isendwin routine returns TRUE if endwin has been called without any subsequent calls to wrefresh, and FALSE otherwise. --
+
The set_term routine is used to switch between different terminals. The screen reference new becomes the new cur- rent terminal. The previous terminal is returned by the @@ -142,16 +134,14 @@ rent terminal. --
+
The delscreen routine frees storage associated with the SCREEN data structure. The endwin routine does not do this, so delscreen should be called after endwin if a par- ticular SCREEN is no longer needed. --
+
endwin returns the integer ERR upon failure and OK upon successful completion. @@ -171,20 +161,17 @@ o set_term returns no error. --
+
Note that initscr and newterm may be macros. --
+
These functions were described in the XSI Curses standard, Issue 4. As of 2015, the current document is X/Open Curs- es, Issue 7. --
+
X/Open specifies that portable applications must not call initscr more than once: @@ -200,8 +187,7 @@ the return value of initscr in XSI Curses. --
+
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 @@ -211,8 +197,7 @@ ly. --
+
Quoting from X/Open Curses, section 3.1.1: Curses implementations may provide for special han- @@ -274,8 +259,7 @@ stdscr, and update other data such as LINES and COLS. --
+
curses(3x), curs_kernel(3x), curs_refresh(3x), curs_slk(3x), curs_terminfo(3x), curs_util(3x), curs_vari- ables(3x).