summaryrefslogtreecommitdiff
path: root/xev.man
diff options
context:
space:
mode:
Diffstat (limited to 'xev.man')
-rw-r--r--xev.man24
1 files changed, 16 insertions, 8 deletions
diff --git a/xev.man b/xev.man
index 1e0eea6..e4c29a0 100644
--- a/xev.man
+++ b/xev.man
@@ -1,6 +1,6 @@
.\" $XConsortium: xev.man,v 1.10 94/04/17 20:45:20 gildea Exp $
.\"
-.\" $XFree86: xc/programs/xev/xev.man,v 1.3 2001/01/27 18:21:11 dawes Exp $
+.\" $XFree86: xc/programs/xev/xev.man,v 1.4 2003/05/24 15:49:02 herrb Exp $
.\"
.TH XEV 1 __xorgversion__
.SH NAME
@@ -13,31 +13,39 @@ xev - print contents of X events
.SH DESCRIPTION
.PP
\fIXev\fP creates a window and then asks the X server to send it
-\fIevents\fP whenever anything happens to the window (such as being moved,
-resized, typed in, clicked in, etc.). You can also attach it to an
-existing window. It is useful for seeing what causes
-events to occur and to display the information that they contain.
+\fIevents\fP whenever anything happens to the window (such as it being
+moved, resized, typed in, clicked in, etc.). You can also attach it to an
+existing window. It is useful for seeing what causes events to occur and to
+display the information that they contain; it is essentially a debugging and
+development tool, and should not be needed in normal usage.
.SH OPTIONS
.TP 8
.B \-display \fIdisplay\fP
This option specifies the X server to contact.
.TP 8
.B \-geometry \fIgeom\fP
-This option specifies the size and/or location of the window.
+This option specifies the size and/or location of the window, if a window is
+to be created.
.TP 8
.B \-bw \fIpixels\fP
This option specifies the border width for the window.
.TP 8
.B \-bs \fI{NotUseful,WhenMapped,Always}\fP
This option specifies what kind of backing store to give the window.
-The default is NotUseful.
+The default is NotUseful. Backing store refers to the the pixels saved
+off-screen when the X server maintains the contents of a window; NotUseful
+means that the xev process will redraw its contents itself, as necessary.
.TP 8
.B \-id \fIwindowid\fP
This option specifies that the window with the given id should be
monitored, instead of creating a new window.
.TP 8
.B \-s
-This option specifies that save-unders should be enabled on the window.
+This option specifies that save-unders should be enabled on the window. Save
+unders are similar to backing store, but they refer rather to the saving of
+pixels off-screen when the current window obscures other windows. Save
+unders are only advisory, and are normally set for popup dialogs and other
+transient windows.
.TP 8
.B \-name \fIstring\fP
This option specifies the name to assign to the created window.