diff options
Diffstat (limited to 'man')
| -rw-r--r-- | man/Makefile.am | 12 | ||||
| -rw-r--r-- | man/xkill.man | 87 |
2 files changed, 99 insertions, 0 deletions
diff --git a/man/Makefile.am b/man/Makefile.am new file mode 100644 index 0000000..40fccb7 --- /dev/null +++ b/man/Makefile.am @@ -0,0 +1,12 @@ + +appmandir = $(APP_MAN_DIR) +appman_PRE = xkill.man +appman_DATA = $(appman_PRE:man=$(APP_MAN_SUFFIX)) + +EXTRA_DIST = $(appman_PRE) +CLEANFILES = $(appman_DATA) +SUFFIXES = .$(APP_MAN_SUFFIX) .man + +# String replacements in MAN_SUBSTS now come from xorg-macros.m4 via configure +.man.$(APP_MAN_SUFFIX): + $(AM_V_GEN)$(SED) $(MAN_SUBSTS) < $< > $@ 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 |