X-Git-Url: https://ncurses.scripts.mit.edu/?p=ncurses.git;a=blobdiff_plain;f=doc%2Fhtml%2Fman%2Fcurs_inopts.3x.html;h=214f949f4fe8f107405c38aa610204aa437bfab4;hp=4776a17f5e50b6e2c48814213a695b5bcea22a66;hb=e6f4ffe150c7d919792f29a70b4f031cfab5ef06;hpb=71c0306f0824ef2b10c4c5813fb003db48f3012e;ds=sidebyside diff --git a/doc/html/man/curs_inopts.3x.html b/doc/html/man/curs_inopts.3x.html index 4776a17f..214f949f 100644 --- a/doc/html/man/curs_inopts.3x.html +++ b/doc/html/man/curs_inopts.3x.html @@ -1,7 +1,7 @@ - + @@ -229,24 +229,58 @@ ty, set echo or noecho explicitly just after initializa- tion, even if your program remains in cooked mode. + 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 + 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 + differ from one execution of a program to the next. The + generated keycodes are recognized by the keyname function + (which will then return a name beginning with "k" denoting + the terminfo capability name rather than "K", used for + 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, + and reassign the keycode to match its own needs. + + Low-level applications can use tigetstr to obtain the def- + inition of any particular string capability. Higher-level + applications which use the curses wgetch and similar func- + tions to return keycodes rely upon the order in which the + strings are loaded. If more than one key definition has + the same string value, then wgetch can return only one + keycode. Most curses implementations (including ncurses) + load key definitions in the order defined by the array of + string capability names. The last key to be loaded deter- + mines the keycode which will be returned. In ncurses, you + may also have extended capabilities interpreted as key + definitions. These are loaded after the predefined keys, + and if a capability's value is the same as a previously- + loaded key definition, the later definition is the one + used. +

NOTES

-       Note that echo, noecho, halfdelay, intrflush, meta,  node-
-       lay,  notimeout, noqiflush, qiflush, timeout, and wtimeout
+       Note  that echo, noecho, halfdelay, intrflush, meta, node-
+       lay, notimeout, noqiflush, qiflush, timeout, and  wtimeout
        may be macros.
 
        The noraw and nocbreak calls follow historical practice in
-       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
+       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
        recommended.

SEE ALSO

-       curses(3x), curs_getch(3x), curs_initscr(3x), termio(7)
+       curses(3x),       curs_getch(3x),        curs_initscr(3x),
+       curs_util(3x), define_key(3x), termio(7)