X-Git-Url: https://ncurses.scripts.mit.edu/?p=ncurses.git;a=blobdiff_plain;f=doc%2Fhtml%2Fman%2Fcurs_getch.3x.html;h=c72a2944ed30fc1fd322dceec2f0f0b4060d9d34;hp=1a3b37648e83410da5e98e129759239fab7b9485;hb=29a36e53e1f77a0c3672f2e267d573823d6a9a60;hpb=6208c89f98f1cf9fe0980bd8e791846ce007a13d;ds=sidebyside diff --git a/doc/html/man/curs_getch.3x.html b/doc/html/man/curs_getch.3x.html index 1a3b3764..c72a2944 100644 --- a/doc/html/man/curs_getch.3x.html +++ b/doc/html/man/curs_getch.3x.html @@ -1,7 +1,7 @@ @@ -102,11 +102,19 @@
If keypad is TRUE, and a function key is pressed, the to- ken for that function key is returned instead of the raw - characters. Possible function keys are defined in <curs- - es.h> as macros with values outside the range of 8-bit - characters whose names begin with KEY_. Thus, a variable - intended to hold the return value of a function key must - be of short size or larger. + characters: + + o The predefined function keys are listed in <curses.h> + as macros with values outside the range of 8-bit char- + acters. Their names begin with KEY_. + + o Other (user-defined) function keys which may be de- + fined using define_key(3x) have no names, but also are + expected to have values outside the range of 8-bit + characters. + + Thus, a variable intended to hold the return value of a + function key must be of short size or larger. When a character that could be the beginning of a function key is received (which, on modern terminals, means an es- @@ -117,6 +125,14 @@ experience a delay between the time a user presses the es- cape key and the escape is returned to the program. + In ncurses, the timer normally expires after the value in + ESCDELAY (see curs_variables(3x)). If notimeout is TRUE, + the timer does not expire; it is an infinite (or very + large) value. Because function keys usually begin with an + escape character, the terminal may appear to hang in no- + timeout mode after pressing the escape key until another + key is pressed. +
The ungetch routine places ch back onto the input queue to @@ -163,6 +179,7 @@ KEY_SR Scroll 1 line backward (reverse) KEY_NPAGE Next page KEY_PPAGE Previous page + KEY_STAB Set tab KEY_CTAB Clear tab KEY_CATAB Clear all tabs @@ -179,7 +196,6 @@ KEY_BTAB Back tab key KEY_BEG Beg(inning) key KEY_CANCEL Cancel key - KEY_CLOSE Close key KEY_COMMAND Cmd (command) key KEY_COPY Copy key @@ -229,6 +245,7 @@ KEY_SREDO Shifted redo key KEY_SREPLACE Shifted replace key KEY_SRIGHT Shifted right arrow + KEY_SRSUME Shifted resume key KEY_SSAVE Shifted save key KEY_SSUSPEND Shifted suspend key @@ -384,8 +401,8 @@
curses(3x), curs_inopts(3x), curs_outopts(3x), - curs_mouse(3x), curs_move(3x), curs_refresh(3x), re- - sizeterm(3x). + curs_mouse(3x), curs_move(3x), curs_refresh(3x), + curs_variables(3x), resizeterm(3x). Comparable functions in the wide-character (ncursesw) li- brary are described in curs_get_wch(3x).