summaryrefslogtreecommitdiff
path: root/man/xkill.man
diff options
context:
space:
mode:
authorGaetan Nadon <memsize@videotron.ca>2011-01-19 10:06:56 -0500
committerGaetan Nadon <memsize@videotron.ca>2011-01-19 10:06:56 -0500
commit0df97b3ed03c528ba99876cd312e20f3c80dff0f (patch)
treefc1ff1dd91e2387f8b2b8dc9985f189bfd747938 /man/xkill.man
parenta7347343c1e27f0f55f9198082bb64ab89b48587 (diff)
config: move man pages into their own directory
Use services provided by XORG_MANPAGE_SECTIONS. Use standard Makefile for man pages. Signed-off-by: Gaetan Nadon <memsize@videotron.ca>
Diffstat (limited to 'man/xkill.man')
-rw-r--r--man/xkill.man87
1 files changed, 87 insertions, 0 deletions
diff --git a/man/xkill.man b/man/xkill.man
new file mode 100644
index 0000000..87ddc0d
--- /dev/null
+++ b/man/xkill.man
@@ -0,0 +1,87 @@
+.\" Copyright 1988, 1998 The Open Group
+.\"
+.\" Permission to use, copy, modify, distribute, and sell this software and its
+.\" documentation for any purpose is hereby granted without fee, provided that
+.\" the above copyright notice appear in all copies and that both that
+.\" copyright notice and this permission notice appear in supporting
+.\" documentation.
+.\"
+.\" The above copyright notice and this permission notice shall be included
+.\" in all copies or substantial portions of the Software.
+.\"
+.\" THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
+.\" OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+.\" MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
+.\" IN NO EVENT SHALL THE OPEN GROUP BE LIABLE FOR ANY CLAIM, DAMAGES OR
+.\" OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE,
+.\" ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
+.\" OTHER DEALINGS IN THE SOFTWARE.
+.\"
+.\" Except as contained in this notice, the name of The Open Group shall
+.\" not be used in advertising or otherwise to promote the sale, use or
+.\" other dealings in this Software without prior written authorization
+.\" from The Open Group.
+.\"
+.TH XKILL 1 __xorgversion__
+.SH NAME
+xkill - kill a client by its X resource
+.SH SYNOPSIS
+.B "xkill"
+[\-display \fIdisplayname\fP] [\-id \fIresource\fP] [\-button number] [\-frame] [\-all]
+.SH DESCRIPTION
+.PP
+.I Xkill
+is a utility for forcing the X server to close connections to clients. This
+program is very dangerous, but is useful for aborting programs that have
+displayed undesired windows on a user's screen. If no resource identifier
+is given with \fI-id\fP, \fIxkill\fP will display a special cursor
+as a prompt for the user to select a window to be killed. If a pointer button
+is pressed over a non-root window, the server will close its connection to
+the client that created the window.
+.SH OPTIONS
+.TP 8
+.B \-display \fIdisplayname\fP
+This option specifies the name of the X server to contact.
+.TP 8
+.B \-id \fIresource\fP
+This option specifies the X identifier for the resource whose creator is
+to be aborted. If no resource is specified, \fIxkill\fP will display a
+special cursor with which you should select a window to be kill.
+.TP 8
+.B \-button \fInumber\fP
+This option specifies the number of pointer button
+that should be used in selecting a window to kill.
+If the word "any" is specified, any button on the pointer may be used. By
+default, the first button in the pointer map (which is usually the leftmost
+button) is used.
+.TP 8
+.B \-all
+This option indicates that all clients with top-level windows on the screen
+should be killed. \fIXkill\fP will ask you to select the root window with
+each of the currently defined buttons to give you several chances to abort.
+Use of this option is highly discouraged.
+.TP 8
+.B \-frame
+This option indicates that xkill should ignore the standard conventions for
+finding top-level client windows (which are typically nested inside a window
+manager window), and simply believe that you want to kill direct children of
+the root.
+.SH CAVEATS
+This command does not provide any warranty that the application whose
+connection to the X server is closed will abort nicely, or even abort
+at all. All this command does is to close the connection to the X
+server. Many existing applications do indeed abort when their
+connection to the X server is closed, but some can choose to
+continue.
+.SH XDEFAULTS
+.TP 8
+.B Button
+Specifies a specific pointer button number or the word "any" to use when
+selecting windows.
+.SH "SEE ALSO"
+X(__miscmansuffix__), xwininfo(__appmansuffix__), XKillClient and XGetPointerMapping in the Xlib Programmers
+Manual, KillClient in the X Protocol Specification
+.SH AUTHOR
+Jim Fulton, MIT X Consortium
+.br
+Dana Chee, Bellcore