X-Git-Url: http://ncurses.scripts.mit.edu/?a=blobdiff_plain;f=man%2Fcurs_sp_funcs.3x;h=7f4be40179b12ef1287011fad3f967ed6e44c9eb;hb=bf2c36c4930ac5bb04cd2b1ba209cd09b6f510ab;hp=193cff67f5788211c921ff80bb112ca950497e1d;hpb=894a177fd5228cdbe790bd1dc9435bd435c29681;p=ncurses.git diff --git a/man/curs_sp_funcs.3x b/man/curs_sp_funcs.3x index 193cff67..7f4be401 100644 --- a/man/curs_sp_funcs.3x +++ b/man/curs_sp_funcs.3x @@ -27,8 +27,8 @@ .\" authorization. * .\"*************************************************************************** .\" -.\" $Id: curs_sp_funcs.3x,v 1.41 2023/10/07 21:33:35 tom Exp $ -.TH curs_sp_funcs 3X 2023-10-07 "ncurses 6.4" "Library calls" +.\" $Id: curs_sp_funcs.3x,v 1.46 2023/12/23 16:26:05 tom Exp $ +.TH curs_sp_funcs 3X 2023-12-23 "ncurses 6.4" "Library calls" .ie \n(.g \{\ .ds `` \(lq .ds '' \(rq @@ -53,7 +53,7 @@ \fBbool can_change_color_sp(SCREEN* \fIsp\fP); \fBint cbreak_sp(SCREEN* \fIsp\fP); \fBint color_content_sp(SCREEN* \fIsp\fP, short \fIcolor\fP, short* \fIr\fP, short* \fIg\fP, short* \fIb\fP); -\fBint curs_set_sp(SCREEN* \fIsp\fP, int \fIvisibility\fR); +\fBint curs_set_sp(SCREEN* \fIsp\fP, int \fIvisibility\fP); \fBint def_prog_mode_sp(SCREEN* \fIsp\fP); \fBint def_shell_mode_sp(SCREEN* \fIsp\fP); .PP @@ -202,7 +202,7 @@ .PP \fBint tigetnum_sp(SCREEN* \fIsp\fP, const char *\fIcapname\fP); \fBchar* tigetstr_sp(SCREEN* \fIsp\fP, const char *\fIcapname\fP); -\fI/* may instead use 9 long parameters */ +\fI/* tparm_sp may use 9 long parameters rather than being variadic */ \fBchar* tparm_sp(SCREEN* \fIsp\fP, const char *\fIstr\fP, ...); \fBint tputs_sp(SCREEN* \fIsp\fP, const char *\fIstr\fP, int \fIaffcnt\fP, NCURSES_SP_OUTC \fIputc\fP); .PP @@ -213,14 +213,15 @@ .SH DESCRIPTION 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 +This feature can be added to any of the configurations supported by +\fI\%ncurses\fP; +it adds new symbols without changing the meaning of any of the existing ones. .\" *************************************************************************** -.SS IMPROVED FUNCTIONS +.SS "Improved Functions" Most of the functions are new versions of existing functions. A parameter is added at the front of the parameter list. -It is a SCREEN pointer. +It is a \fISCREEN\fP pointer. .PP The existing functions all use the current screen, which is a static variable. @@ -228,7 +229,7 @@ The extended functions use the specified screen, thereby reducing the number of variables which must be modified to update multiple screens. .\" *************************************************************************** -.SS NEW FUNCTIONS +.SS "New Functions" Here are the new functions: .TP 5 ceiling_panel @@ -244,8 +245,8 @@ With the screen-pointer extension, there are situations where it must create a current screen before the unextended library does. The \fBnew_prescr\fP function is used internally to handle these cases. -It is also provided as an entrypoint to allow applications to customize -the library initialization. +It is also provided to allow applications to customize library +initialization. .\" *************************************************************************** .SH NOTES This extension introduces some new names: @@ -273,9 +274,9 @@ NCURSES_OUTC This is a function-pointer type used for the cases where a function passes characters to the output stream, e.g., \fBvidputs\fP(3X). .SH PORTABILITY -These routines are specific to ncurses. +These routines are specific to \fI\%ncurses\fP. They were not supported on Version 7, BSD or System V implementations. -It is recommended that any code depending on ncurses extensions +It is recommended that any code depending on \fI\%ncurses\fP extensions be conditioned using \fINCURSES_SP_FUNCS\fP. .SH SEE ALSO \fB\%curses\fP(3X),