X-Git-Url: https://ncurses.scripts.mit.edu/?p=ncurses.git;a=blobdiff_plain;f=doc%2Fhtml%2Fman%2Fcurs_util.3x.html;h=ad619492b2b6d0bb28c41936a492180f01e4f6f0;hp=760298dc891aa64ecf8a7f0fd7a0a8234b99d999;hb=027ae42953e3186daed8f3882da73de48291b606;hpb=55ccd2b959766810cf7db8d1c4462f338ce0afc8 diff --git a/doc/html/man/curs_util.3x.html b/doc/html/man/curs_util.3x.html index 760298dc..ad619492 100644 --- a/doc/html/man/curs_util.3x.html +++ b/doc/html/man/curs_util.3x.html @@ -1,7 +1,7 @@ @@ -48,8 +48,8 @@

NAME

        delay_output, filter, flushinp, getwin, key_name, keyname,
-       putwin, unctrl, use_env, wunctrl - miscellaneous curses
-       utility routines
+       nofilter, putwin, unctrl, use_env, wunctrl - miscellaneous
+       curses utility routines
@@ -61,6 +61,7 @@ char *keyname(int c); char *key_name(wchar_t w); void filter(void); + void nofilter(void); void use_env(bool f); int putwin(WINDOW *win, FILE *filep); WINDOW *getwin(FILE *filep); @@ -93,6 +94,12 @@ cud, cud1, cuu1, cuu, vpa are disabled; and the home string is set to the value of cr. + The nofilter routine cancels the effect of a preceding + filter call. That allows the caller to initialize a + screen on a different device, using a different value of + $TERM. The limitation arises because the filter routine + modifies the in-memory copy of the terminal information. + The use_env routine, if used, is called before initscr or newterm are called. When called with FALSE as an argu- ment, the values of lines and columns specified in the @@ -159,20 +166,33 @@ The strings returned by unctrl in this implementation are determined at compile time, showing C1 controls from the upper-128 codes with a `~' prefix rather than `^'. Other - implementations typically show both sets of control char- - acters with `^', and may strip the parameter to 7 bits. - This implementation uses 8 bits but does not modify the - string to reflect locale. - - The keyname function may return the names of user-defined - string capabilities which are defined in the terminfo en- - try via the -x option of tic. + implementations have different conventions. For example, + they may show both sets of control characters with `^', + and strip the parameter to 7 bits. Or they may ignore C1 + controls and treat all of the upper-1280 codes as print- + able. This implementation uses 8 bits but does not modify + the string to reflect locale. The use_legacy_coding func- + tion allows the caller to change the output of unctrl. + + The keyname function may return the names of user-defined + string capabilities which are defined in the terminfo en- + try via the -x option of tic. This implementation auto- + matically assigns at run-time keycodes to user-defined + strings which begin with "k". The keycodes start at + KEY_MAX, but are not guaranteed to be the same value for + different runs because user-defined codes are merged from + all terminal descriptions which have been loaded. + + The nofilter routine is specific to ncurses. It was not + supported on Version 7, BSD or System V implementations. + It is recommended that any code depending on ncurses ex- + tensions be conditioned using NCURSES_VERSION.

SEE ALSO

-       curses(3x),       curs_initscr(3x),       curs_kernel(3x),
-       curs_scr_dump(3x).
+       use_legacy_coding(3),    curses(3x),     curs_initscr(3x),
+       curs_kernel(3x), curs_scr_dump(3x).