ncurses 6.4 - patch 20231223

[ncurses.git] / man / curs_threads.3x

diff --git a/man/curs_threads.3x b/man/curs_threads.3x
index 9df26ba25856102c223dbd0e40992b8421e8ec06..1e4254406a8fde0583747500de606ed8ae325ae3 100644 (file)
--- a/man/curs_threads.3x
+++ b/man/curs_threads.3x
@@ -28,8 +28,8 @@
 .\" authorization.                                                           *
 .\"***************************************************************************
 .\"
-.\" $Id: curs_threads.3x,v 1.47 2023/10/07 21:19:07 tom Exp $
-.TH curs_threads 3X 2023-10-07 "ncurses 6.4" "Library calls"
+.\" $Id: curs_threads.3x,v 1.51 2023/12/23 16:22:25 tom Exp $
+.TH curs_threads 3X 2023-12-23 "ncurses 6.4" "Library calls"
 .ie \n(.g \{\
 .ds `` \(lq
 .ds '' \(rq
@@ -70,26 +70,27 @@
 \fBint use_window(WINDOW *\fIwin\fP, NCURSES_WINDOW_CB \fIfunc\fP, void *\fIdata\fP);
 .fi
 .SH DESCRIPTION
-The \fIncurses\fP library can be configured to support multi-threaded
+The \fI\%ncurses\fP library can be configured to support multi-threaded
 applications in a rudimentary way.
 Such configuration produces a different set of libraries,
 named \fIlibncursest\fP,
 for example,
-since doing so alters \fIncurses\fP's application binary interface
+since doing so alters \fI\%ncurses\fP's application binary interface
 (ABI).
 .PP
 Instead of modifying the programming interface (API) to make
-\fIncurses\fP functions expect an additional argument specifying a
+\fI\%ncurses\fP functions expect an additional argument specifying a
 thread,
-the library adds a few functions,
+the library adds functions,
 usable in any configuration,
 that hide the \fImutexes\fP
 (mutual exclusion locks)
 needed to prevent concurrent access to variables shared by multiple
 threads of execution.
 .PP
-\fIncurses\fP threading support requires the use of functions to access
-members of the \fI\%WINDOW\fP structure (see \fBcurs_opaque\fP(3X)).
+\fI\%ncurses\fP threading support requires the use of functions to
+access members of the \fI\%WINDOW\fP structure (see
+\fBcurs_opaque\fP(3X)).
 It further makes functions of the common global variables
 \fB\%COLORS\fP,
 \fB\%COLOR_PAIRS\fP,
@@ -121,13 +122,13 @@ Other global variables are not modifiable.
 .PP
 The \fBuse_window\fP and \fBuse_screen\fP functions provide
 coarse-grained mutexes for their respective \fI\%WINDOW\fP and
-\fI\%SCREEN\fP parameters;
+\fISCREEN\fP parameters;
 they call a user-supplied function,
 pass it a \fIdata\fP parameter,
 and return the value from the user-supplied function to the application.
 .\" ***************************************************************************
 .SS Usage
-All \fIncurses\fP library functions assume that the locale is not
+All \fI\%ncurses\fP library functions assume that the locale is not
 altered during operation.
 In addition,
 they use data that is maintained within a hierarchy of scopes.
@@ -154,8 +155,9 @@ single screen.
 reentrant data associated with \*(``pure\*('' functions that alter no
 shared variables
 .PP
-The following table lists the scope of each symbol in the \fIncurses\fP
-library when configured to support multi-threaded applications.
+The following table lists the scope of each symbol in the
+\fI\%ncurses\fP library when configured to support multi-threaded
+applications.
 .PP
 .TS
 center tab(/);
@@ -623,12 +625,12 @@ failure and \fBOK\fP upon successful completion.
 \fB\%use_screen\fP and \fB\%use_window\fP return the \fIint\fP returned
 by the user-supplied function they are called with.
 .SH NOTES
-\fIncurses\fP provides both a C function and a preprocessor macro for
+\fI\%ncurses\fP provides both a C function and a preprocessor macro for
 each function documented in this page.
 .SH PORTABILITY
-These routines are specific to \fIncurses\fP.
+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 \fIncurses\fP extensions
+It is recommended that any code depending on \fI\%ncurses\fP extensions
 be conditioned using \fB\%NCURSES_VERSION\fP.
 .SH SEE ALSO
 \fB\%curses\fP(3X),