X-Git-Url: http://ncurses.scripts.mit.edu/?p=ncurses.git;a=blobdiff_plain;f=doc%2Fhtml%2Fman%2Fcurs_extend.3x.html;h=e81173997ca5ba3bc89a745f5e717f186829121d;hp=c9f39309a0d56a45a8b842b609afc4cad924bebe;hb=HEAD;hpb=b0b1980be11bba618d84beb8b30ac94e2c820602 diff --git a/doc/html/man/curs_extend.3x.html b/doc/html/man/curs_extend.3x.html index c9f39309..4bf9c804 100644 --- a/doc/html/man/curs_extend.3x.html +++ b/doc/html/man/curs_extend.3x.html @@ -1,7 +1,7 @@ - - +
-- -curs_extend(3x) curs_extend(3x) +curs_extend(3x) Library calls curs_extend(3x) --
- curses_version, use_extended_names - miscellaneous curses - extensions +
+ curses_version, use_extended_names - miscellaneous curses extensions --
+
#include <curses.h> const char * curses_version(void); - int use_extended_names(bool enable); + int use_extended_names(bool enable); --
- These functions are extensions to the curses library which - do not fit easily into other categories. +
+ These functions are extensions to the curses library which do not fit + easily into other categories. - Use curses_version() to get the version number, including - patch level of the library, e.g., 5.0.19991023 - The use_extended_names() function controls whether the - calling application is able to use user-defined or non- - standard names which may be compiled into the terminfo - description, i.e., via the terminfo or termcap interfaces. - Normally these names are available for use, since the - essential decision is made by using the -x option of tic - to compile extended terminal definitions. However you can - disable this feature to ensure compatibility with other - implementations of curses. +
+ Use curses_version to get the version number, including patch level of + the library, prefixed by "ncurses", e.g., + ncurses 5.0.19991023 --
- These routines are specific to ncurses. They were not - supported on Version 7, BSD or System V implementations. - It is recommended that any code depending on them be con- - ditioned using NCURSES_VERSION. +
+ The use_extended_names function controls whether the calling + application is able to use user-defined or nonstandard names which may + be compiled into the terminfo description, i.e., via the terminfo or + termcap interfaces. Normally these names are available for use, since + the essential decision is made by using the -x option of tic to compile + extended terminal definitions. However you can disable this feature to + ensure compatibility with other implementations of curses. --
- curs_getch(3x), curs_mouse(3x), curs_print(3x), - curs_util(3x), default_colors(3x), define_key(3x), key- - bound(3x), keyok(3x), resizeterm(3x), wresize(3x). +
+ curses_version returns a pointer to static memory; you should not free + this in your application. --
+ use_extended_names returns the previous state, allowing you to save + this and restore it. + + +
+ These functions are ncurses(3x) extensions, and are not found in SVr4 + curses, 4.4BSD curses, or any other previous curses implementation. + + +
+ Applications employing ncurses extensions should condition their use on + the visibility of the NCURSES_VERSION preprocessor macro. + + +
Thomas Dickey. +
+ curs_getch(3x), curs_mouse(3x), curs_print(3x), curs_util(3x), + default_colors(3x), define_key(3x), keybound(3x), keyok(3x), + resizeterm(3x), wresize(3x) + + - curs_extend(3x) +ncurses 6.4 2024-03-16 curs_extend(3x)-