.\" 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
\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
.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
.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.
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
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:
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),