From 18cfc63da9ca5818d4d766b83917e1c20600517e Mon Sep 17 00:00:00 2001
From: "B. Watson" <urchlay@slackware.uk>
Date: Wed, 31 Jan 2024 02:22:19 -0500
Subject: Expand man page a bit.

---
 xdeadzone.1   | 22 ++++++++++++++++++----
 xdeadzone.rst | 24 ++++++++++++++++++++----
 2 files changed, 38 insertions(+), 8 deletions(-)

diff --git a/xdeadzone.1 b/xdeadzone.1
index 0e4a61d..3bb3184 100644
--- a/xdeadzone.1
+++ b/xdeadzone.1
@@ -41,16 +41,27 @@ xdeadzone [\fB\-nw\fP | \fB\-ne\fP | \fB\-sw\fP | \fB\-se\fP | \fB\-abs\fP \fIx\
 xdeadzone \fB\-\-help\fP | \fB\-\-version\fP
 .SH DESCRIPTION
 .sp
-xdeadzone\(aqs job is to create a window of a specified size, and prevent
-the mouse pointer from entering it.
+\fBxdeadzone\fP\(aqs job is to create a window of a specified size and
+position, and prevent the mouse pointer from entering it.
 .sp
 The intended use for it is to keep the mouse out of the "dead zone"
 of a multi\-head X display where the monitors don\(aqt all have the same
-resolution.
+resolution. When used for this purpose, there will be no visible
+\fBxdeadzone\fP window (if there is, you\(aqve got the size and/or position
+wrong).
 .sp
 It could also be useful for covering annoying parts of the screen,
 e.g. advertisements in ad\-driven software like the Opera browser, or
-Adobe Reader.
+Adobe Reader. Use \fB\-abs\fP (absolute positioning) mode for this.
+.sp
+When \fBxdeadzone\fP is running in a visible part of the screen, it\(aqll
+appear as a solid white rectangle with no title bar or window frame;
+it\(aqll stay on top of other windows; and it will appear on every
+virtual desktop.
+.sp
+\fBxdeadzone\fP has been tested with various window managers and desktop
+environments, and works properly with at least: KDE (Plasma 5), XFCE
+4, Fmwv2, WindowMaker, BlackBox, and FluxBox.
 .SH OPTIONS
 .INDENT 0.0
 .TP
@@ -156,5 +167,8 @@ See \fI\%http://www.wtfpl.net/txt/copying/\fP for details.
 .SH AUTHORS
 .sp
 \fBxdeadzone\fP was written by B. Watson (\fI\%urchlay@slackware.uk\fP).
+.SH SEE ALSO
+.sp
+\fBxrandr\fP(1)
 .\" Generated by docutils manpage writer.
 .
diff --git a/xdeadzone.rst b/xdeadzone.rst
index ff12bd7..20e9c90 100644
--- a/xdeadzone.rst
+++ b/xdeadzone.rst
@@ -27,16 +27,27 @@ xdeadzone **--help** | **--version**
 DESCRIPTION
 ===========
 
-xdeadzone's job is to create a window of a specified size, and prevent
-the mouse pointer from entering it.
+**xdeadzone**'s job is to create a window of a specified size and
+position, and prevent the mouse pointer from entering it.
 
 The intended use for it is to keep the mouse out of the "dead zone"
 of a multi-head X display where the monitors don't all have the same
-resolution.
+resolution. When used for this purpose, there will be no visible
+**xdeadzone** window (if there is, you've got the size and/or position
+wrong).
 
 It could also be useful for covering annoying parts of the screen,
 e.g. advertisements in ad-driven software like the Opera browser, or
-Adobe Reader.
+Adobe Reader. Use **-abs** (absolute positioning) mode for this.
+
+When **xdeadzone** is running in a visible part of the screen, it'll
+appear as a solid white rectangle with no title bar or window frame;
+it'll stay on top of other windows; and it will appear on every
+virtual desktop.
+
+**xdeadzone** has been tested with various window managers and desktop
+environments, and works properly with at least: KDE (Plasma 5), XFCE
+4, Fmwv2, WindowMaker, BlackBox, and FluxBox.
 
 OPTIONS
 =======
@@ -134,3 +145,8 @@ AUTHORS
 =======
 
 **xdeadzone** was written by B. Watson (urchlay@slackware.uk).
+
+SEE ALSO
+========
+
+**xrandr**\(1)
-- 
cgit v1.2.3