X-Git-Url: https://ncurses.scripts.mit.edu/?p=ncurses.git;a=blobdiff_plain;f=doc%2Fhtml%2Fman%2Fcurs_sp_funcs.3x.html;h=a11947a74abddb09699984dbdcee430375577c82;hp=ab73bce4b765b1f4ceeab5a75d728505de7e174b;hb=refs%2Ftags%2Fv5.8;hpb=90ffd624948c543a457324ee777717e4130f2ad2 diff --git a/doc/html/man/curs_sp_funcs.3x.html b/doc/html/man/curs_sp_funcs.3x.html index ab73bce4..a11947a7 100644 --- a/doc/html/man/curs_sp_funcs.3x.html +++ b/doc/html/man/curs_sp_funcs.3x.html @@ -193,15 +193,16 @@ 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. + without changing the meaning of any of the existing ones. + IMPROVED FUNCTIONS - Most of the functions are new versions of existing func- + 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. - The existing functions all use the current screen, which - is a static variable. The extended functions use the + 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. @@ -209,22 +210,22 @@ Here are the new functions: ceiling_panel - this returns a pointer to the topmost panel in the + this returns a pointer to the topmost panel in the given screen. ground_panel - this returns a pointer to the lowest panel in the + 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 + 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 + 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 + point to allow applications to customize the library initialization. @@ -233,36 +234,37 @@ 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 + 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. + 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 + unextended function. This manual page indexes the extensions showing the full name. However the proper - usage of these functions uses the macro, to provide + usage of these functions uses the macro, to provide for the possibility of changing the naming convention for specific library configurations. NCURSES_SP_OUTC - This is a new function-pointer type to use in the - screen-pointer functions where an NCURSES_OUTC is + 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 + This is a function-pointer type used for the cases + where a function passes characters to the output stream, e.g., vidputs(3x). +

PORTABILITY

-       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-
+       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.