X-Git-Url: https://ncurses.scripts.mit.edu/?p=ncurses.git;a=blobdiff_plain;f=doc%2Fhtml%2Fman%2Fcurs_sp_funcs.3x.html;h=9a94c6d1efbded57edfe3ef1db146f11f284184e;hp=527a22a7c26863f55d03d75577cfc9cfd6c676c8;hb=0485620c03e69b1b58a6b12e5e45c98415fc7575;hpb=3eda6f30a84d53844d2ebceadb457e2e7e9cfbf3 diff --git a/doc/html/man/curs_sp_funcs.3x.html b/doc/html/man/curs_sp_funcs.3x.html index 527a22a7..9a94c6d1 100644 --- a/doc/html/man/curs_sp_funcs.3x.html +++ b/doc/html/man/curs_sp_funcs.3x.html @@ -43,7 +43,7 @@
-curs_sp_funcs(3x) curs_sp_funcs(3x) +curs_sp_funcs(3x) curs_sp_funcs(3x) @@ -196,81 +196,73 @@
- This implementation can be configured to provide a set of - functions which improve the ability to manage multiple - screens. This feature can be added to any of the configu- - rations supported by ncurses; it adds new entrypoints - without changing the meaning of any of the existing ones. + This implementation can be configured to provide a set of functions + which improve the ability to manage multiple screens. This feature can + be added to any of the configurations supported by ncurses; it adds new + entrypoints without changing the meaning of any of the existing ones.
- Most of the functions are new versions of existing func- - tions. A parameter is added at the front of the parameter - list. It is a SCREEN pointer. + Most of the functions are new versions of existing functions. A param- + eter is added at the front of the parameter list. It is a SCREEN + pointer. - The existing functions all use the current screen, which - is a static variable. The extended functions use the - specified screen, thereby reducing the number of variables - which must be modified to update multiple screens. + The existing functions all use the current screen, which is a static + variable. The extended functions use the specified screen, thereby re- + ducing the number of variables which must be modified to update multi- + ple screens.
Here are the new functions: ceiling_panel - this returns a pointer to the topmost panel in the - given screen. + this returns a pointer to the topmost panel in the given screen. ground_panel - this returns a pointer to the lowest panel in the - given screen. + this returns a pointer to the lowest panel in the given screen. new_prescr - when creating a new screen, the library uses static - variables which have been preset, e.g., by - use_env(3x), filter(3x), etc. With the screen-point- - er extension, there are situations where it must cre- - ate a current screen before the unextended library - does. The new_prescr function is used internally to - handle these cases. It is also provided as an entry- - point to allow applications to customize the library - initialization. + when creating a new screen, the library uses static variables + which have been preset, e.g., by use_env(3x), filter(3x), etc. + With the screen-pointer extension, there are situations where it + must create a current screen before the unextended library does. + The new_prescr function is used internally to handle these cases. + It is also provided as an entrypoint to allow applications to cus- + tomize the library initialization.
This extension introduces some new names: NCURSES_SP_FUNCS - This is set to the library patch-level number. In - the unextended library, this is zero (0), to make it - useful for checking if the extension is provided. + This is set to the library patch-level number. In the unextended + library, this is zero (0), to make it useful for checking if the + extension is provided. NCURSES_SP_NAME - The new functions are named using the macro NCURS- - ES_SP_NAME, which hides the actual implementation. - Currently this adds a "_sp" suffix to the name of the - unextended function. This manual page indexes the - extensions showing the full name. However the proper - usage of these functions uses the macro, to provide - for the possibility of changing the naming convention - for specific library configurations. + The new functions are named using the macro NCURSES_SP_NAME, which + hides the actual implementation. Currently this adds a "_sp" suf- + fix to the name of the unextended function. This manual page in- + dexes the extensions showing the full name. However the proper + usage of these functions uses the macro, to provide for the possi- + bility of changing the naming convention for specific library con- + figurations. NCURSES_SP_OUTC - This is a new function-pointer type to use in the - screen-pointer functions where an NCURSES_OUTC is - used in the unextended library. + This is a new function-pointer type to use in the screen-pointer + functions where an NCURSES_OUTC is used in the unextended library. NCURSES_OUTC - This is a function-pointer type used for the cases - where a function passes characters to the output - stream, e.g., vidputs(3x). + This is a function-pointer type used for the cases where a func- + tion passes characters to the output stream, e.g., vidputs(3x).
- 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 ncurses ex- - tensions be conditioned using NCURSES_SP_FUNCS. + 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 ncurses extensions be conditioned using NCURS- + ES_SP_FUNCS.
@@ -278,7 +270,7 @@ - curs_sp_funcs(3x) + curs_sp_funcs(3x)