X-Git-Url: https://ncurses.scripts.mit.edu/?p=ncurses.git;a=blobdiff_plain;f=doc%2Fhtml%2Fman%2Fcurs_inopts.3x.html;h=1d2db7213a897b79b1565d422162648f307245cf;hp=a7ab87a522db130085e56c0c3391ab86ee3de5fa;hb=ce4803687b821efbc5fb2c5a5f06d69cd4dc2656;hpb=6208c89f98f1cf9fe0980bd8e791846ce007a13d diff --git a/doc/html/man/curs_inopts.3x.html b/doc/html/man/curs_inopts.3x.html index a7ab87a5..1d2db721 100644 --- a/doc/html/man/curs_inopts.3x.html +++ b/doc/html/man/curs_inopts.3x.html @@ -1,6 +1,6 @@ @@ -103,14 +103,14 @@
The echo and noecho routines control whether characters - typed by the user are echoed by getch as they are typed. - Echoing by the tty driver is always disabled, but initial- - ly getch is in echo mode, so 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.] + 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 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.]
@@ -138,15 +138,15 @@
The keypad option enables the keypad of the user's termi- nal. If enabled (bf is TRUE), the user can press a func- - tion key (such as an arrow key) and wgetch returns a sin- - gle 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 local- - ly), turning on this option causes the terminal keypad to - be turned on when wgetch is called. The default value for - keypad is FALSE. + tion 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 in- + terpret 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 termi- + nal keypad to be turned on when wgetch(3x) is called. The + default value for keypad is FALSE.
@@ -169,9 +169,9 @@ If no input is ready, getch returns ERR. If disabled (bf is FALSE), getch waits until a key is pressed. - While interpreting an input escape sequence, wgetch sets a - timer while waiting for the next character. If notime- - out(win, TRUE) is called, then wgetch does not set a + While interpreting an input escape sequence, wgetch(3x) + sets a timer while waiting for the next character. If no- + timeout(win, TRUE) is called, then wgetch does not set a timer. The purpose of the timeout is to differentiate be- tween sequences received from a function key and those typed by a user. @@ -193,8 +193,8 @@ and output queues associated with the INTR, QUIT and SUSP characters will not be done [see termio(7)]. When qiflush is called, the queues will be flushed when these control - characters are read. You may want to call noqiflush() in - a signal handler if you want output to continue as though + characters are read. You may want to call noqiflush in a + signal handler if you want output to continue as though the interrupt had not occurred, after the handler exits. @@ -215,14 +215,14 @@ 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 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 current update is postponed until refresh(3x) or doup- + date is called again. This allows faster response to com- + mands 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 ty- + peahead 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.
@@ -257,7 +257,7 @@ When keypad is first enabled, ncurses loads the key-defi- nitions for the current terminal description. If the ter- minal description includes extended string capabilities, - e.g., from using the -x option of tic, then ncurses also + 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 (de- pending on previous loads of terminal descriptions) may @@ -268,7 +268,7 @@ 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, + 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 def- @@ -294,7 +294,7 @@ may be macros. The noraw and nocbreak calls follow historical practice in - that they attempt to restore to normal (`cooked') mode + 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