summaryrefslogtreecommitdiff
path: root/lib/libX11/man/XInitThreads.man
diff options
context:
space:
mode:
authorMatthieu Herrb <matthieu@cvs.openbsd.org>2020-01-04 17:55:18 +0000
committerMatthieu Herrb <matthieu@cvs.openbsd.org>2020-01-04 17:55:18 +0000
commit1128148d76d7952d7aacfa2b083f5b5a96b4b4d5 (patch)
tree9291b9dfdfb4da1828705353be85e340f302e651 /lib/libX11/man/XInitThreads.man
parent7b7fd95cb6ee85ebe6d6d08b126b770770e86688 (diff)
Uppdate to libX11 1.6.9. Tested by krw@ and naddy@
Diffstat (limited to 'lib/libX11/man/XInitThreads.man')
-rw-r--r--lib/libX11/man/XInitThreads.man64
1 files changed, 16 insertions, 48 deletions
diff --git a/lib/libX11/man/XInitThreads.man b/lib/libX11/man/XInitThreads.man
index 2ca980299..4ae952287 100644
--- a/lib/libX11/man/XInitThreads.man
+++ b/lib/libX11/man/XInitThreads.man
@@ -38,46 +38,13 @@
.\" to this documentation without specific, written prior permission.
.\" Digital and Tektronix makes no representations about the suitability
.\" of this documentation for any purpose.
-.\" It is provided ``as is'' without express or implied warranty.
-.\"
+.\" It is provided "as is" without express or implied warranty.
+.\"
.\"
.ds xT X Toolkit Intrinsics \- C Language Interface
.ds xW Athena X Widgets \- C Language X Toolkit Interface
.ds xL Xlib \- C Language X Interface
.ds xC Inter-Client Communication Conventions Manual
-.na
-.de Ds
-.nf
-.\\$1D \\$2 \\$1
-.ft CW
-.\".ps \\n(PS
-.\".if \\n(VS>=40 .vs \\n(VSu
-.\".if \\n(VS<=39 .vs \\n(VSp
-..
-.de De
-.ce 0
-.if \\n(BD .DF
-.nr BD 0
-.in \\n(OIu
-.if \\n(TM .ls 2
-.sp \\n(DDu
-.fi
-..
-.de IN \" send an index entry to the stderr
-..
-.de Pn
-.ie t \\$1\fB\^\\$2\^\fR\\$3
-.el \\$1\fI\^\\$2\^\fP\\$3
-..
-.de ZN
-.ie t \fB\^\\$1\^\fR\\$2
-.el \fI\^\\$1\^\fP\\$2
-..
-.de hN
-.ie t <\fB\\$1\fR>\\$2
-.el <\fI\\$1\fP>\\$2
-..
-.ny0
.TH XInitThreads __libmansuffix__ __xorgversion__ "XLIB FUNCTIONS"
.SH NAME
XInitThreads, XLockDisplay, XUnlockDisplay \- multi-threading support
@@ -85,15 +52,15 @@ XInitThreads, XLockDisplay, XUnlockDisplay \- multi-threading support
.HP
Status XInitThreads\^(void);
.HP
-void XLockDisplay\^(\^Display *\fIdisplay\fP\^);
+void XLockDisplay\^(\^Display *\fIdisplay\fP\^);
.HP
-void XUnlockDisplay\^(\^Display *\fIdisplay\fP\^);
+void XUnlockDisplay\^(\^Display *\fIdisplay\fP\^);
.SH ARGUMENTS
.IP \fIdisplay\fP 1i
Specifies the connection to the X server.
.SH DESCRIPTION
The
-.ZN XInitThreads
+.B XInitThreads
function initializes Xlib support for concurrent threads.
This function must be the first Xlib function a
multi-threaded program calls, and it must complete
@@ -103,7 +70,8 @@ successful; otherwise, it returns zero.
On systems that do not support threads, this function always returns zero.
.LP
It is only necessary to call this function if multiple threads
-might use Xlib concurrently. If all calls to Xlib functions
+might use Xlib concurrently.
+If all calls to Xlib functions
are protected by some other access mechanism (for example,
a mutual exclusion lock in a toolkit or through explicit client
programming), Xlib thread initialization is not required.
@@ -111,32 +79,32 @@ It is recommended that single-threaded programs not call this function.
.LP
The
-.ZN XLockDisplay
+.B XLockDisplay
function locks out all other threads from using the specified display.
Other threads attempting to use the display will block until
the display is unlocked by this thread.
Nested calls to
-.ZN XLockDisplay
+.B XLockDisplay
work correctly; the display will not actually be unlocked until
-.ZN XUnlockDisplay
+.B XUnlockDisplay
has been called the same number of times as
-.ZN XLockDisplay .
+.BR XLockDisplay .
This function has no effect unless Xlib was successfully initialized
for threads using
-.ZN XInitThreads .
+.BR XInitThreads .
.LP
The
-.ZN XUnlockDisplay
+.B XUnlockDisplay
function allows other threads to use the specified display again.
Any threads that have blocked on the display are allowed to continue.
Nested locking works correctly; if
-.ZN XLockDisplay
+.B XLockDisplay
has been called multiple times by a thread, then
-.ZN XUnlockDisplay
+.B XUnlockDisplay
must be called an equal number of times before the display is
actually unlocked.
This function has no effect unless Xlib was successfully initialized
for threads using
-.ZN XInitThreads .
+.BR XInitThreads .
.SH "SEE ALSO"
\fI\*(xL\fP