diff options
author | Matthieu Herrb <matthieu@cvs.openbsd.org> | 2020-01-04 17:55:18 +0000 |
---|---|---|
committer | Matthieu Herrb <matthieu@cvs.openbsd.org> | 2020-01-04 17:55:18 +0000 |
commit | 1128148d76d7952d7aacfa2b083f5b5a96b4b4d5 (patch) | |
tree | 9291b9dfdfb4da1828705353be85e340f302e651 /lib/libX11/man/XSetCloseDownMode.man | |
parent | 7b7fd95cb6ee85ebe6d6d08b126b770770e86688 (diff) |
Uppdate to libX11 1.6.9. Tested by krw@ and naddy@
Diffstat (limited to 'lib/libX11/man/XSetCloseDownMode.man')
-rw-r--r-- | lib/libX11/man/XSetCloseDownMode.man | 94 |
1 files changed, 31 insertions, 63 deletions
diff --git a/lib/libX11/man/XSetCloseDownMode.man b/lib/libX11/man/XSetCloseDownMode.man index 6ae6fd862..7c63f6cd4 100644 --- a/lib/libX11/man/XSetCloseDownMode.man +++ b/lib/libX11/man/XSetCloseDownMode.man @@ -38,122 +38,90 @@ .\" 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 XSetCloseDownMode __libmansuffix__ __xorgversion__ "XLIB FUNCTIONS" .SH NAME XSetCloseDownMode, XKillClient \- control clients .SH SYNTAX .HP -int XSetCloseDownMode\^(\^Display *\fIdisplay\fP\^, int \fIclose_mode\fP\^); +int XSetCloseDownMode\^(\^Display *\fIdisplay\fP\^, int \fIclose_mode\fP\^); .HP -int XKillClient\^(\^Display *\fIdisplay\fP\^, XID \fIresource\fP\^); +int XKillClient\^(\^Display *\fIdisplay\fP\^, XID \fIresource\fP\^); .SH ARGUMENTS .IP \fIclose_mode\fP 1i Specifies the client close-down mode. -You can pass -.ZN DestroyAll , -.ZN RetainPermanent , +You can pass +.BR DestroyAll , +.BR RetainPermanent , or -.ZN RetainTemporary . +.BR RetainTemporary . .IP \fIdisplay\fP 1i Specifies the connection to the X server. .IP \fIresource\fP 1i Specifies any resource associated with the client that you want to destroy or -.ZN AllTemporary . +.BR AllTemporary . .SH DESCRIPTION The -.ZN XSetCloseDownMode +.B XSetCloseDownMode defines what will happen to the client's resources at connection close. A connection starts in -.ZN DestroyAll +.B DestroyAll mode. For information on what happens to the client's resources when the close_mode argument is -.ZN RetainPermanent +.B RetainPermanent or -.ZN RetainTemporary , +.BR RetainTemporary , see section 2.6. .LP -.ZN XSetCloseDownMode +.B XSetCloseDownMode can generate a -.ZN BadValue +.B BadValue error. .LP The -.ZN XKillClient +.B XKillClient function forces a close down of the client that created the resource if a valid resource is specified. If the client has already terminated in -either -.ZN RetainPermanent -or -.ZN RetainTemporary +either +.B RetainPermanent +or +.B RetainTemporary mode, all of the client's resources are destroyed. -If -.ZN AllTemporary +If +.B AllTemporary is specified, the resources of all clients that have terminated in -.ZN RetainTemporary +.B RetainTemporary are destroyed (see section 2.5). This permits implementation of window manager facilities that aid debugging. A client can set its close-down mode to -.ZN RetainTemporary . +.BR RetainTemporary . If the client then crashes, -its windows would not be destroyed. -The programmer can then inspect the application's window tree +its windows would not be destroyed. +The programmer can then inspect the application's window tree and use the window manager to destroy the zombie windows. .LP -.ZN XKillClient +.B XKillClient can generate a -.ZN BadValue +.B BadValue error. .SH DIAGNOSTICS .TP 1i -.ZN BadValue +.B BadValue Some numeric value falls outside the range of values accepted by the request. Unless a specific range is specified for an argument, the full range defined -by the argument's type is accepted. Any argument defined as a set of +by the argument's type is accepted. +Any argument defined as a set of alternatives can generate this error. .SH "SEE ALSO" \fI\*(xL\fP |