merge latest (4.3.99.16) from XFree86 (vendor) branchXEVIE-BASE

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.