aboutsummaryrefslogtreecommitdiff
path: root/xdeadzone.1
diff options
context:
space:
mode:
Diffstat (limited to 'xdeadzone.1')
-rw-r--r--xdeadzone.153
1 files changed, 27 insertions, 26 deletions
diff --git a/xdeadzone.1 b/xdeadzone.1
index 74505d4..115b9d9 100644
--- a/xdeadzone.1
+++ b/xdeadzone.1
@@ -27,7 +27,7 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
..
-.TH "XDEADZONE" 1 "2024-02-03" "0.1" "Urchlay's Misc Stuff"
+.TH "XDEADZONE" 1 "2024-02-04" "0.1" "Urchlay's Misc Stuff"
.SH NAME
xdeadzone \- keep the mouse pointer out of the dead zone, on mismatched multihead displays.
.\" RST source for xdeadzone(1) man page. Convert with:
@@ -36,7 +36,7 @@ xdeadzone \- keep the mouse pointer out of the dead zone, on mismatched multihea
.
.SH SYNOPSIS
.sp
-xdeadzone <[\fB\-i\fP \fB\-b\fP | \fB\-w\fP ]> <\fB\-n*> [\fP\-nw** | \fB\-ne\fP | \fB\-sw\fP | \fB\-se\fP | \fB\-abs\fP] \fIgeometry\fP
+xdeadzone [\fB\-b\fP | \fB\-w\fP ] [\fB\-n*] [\fP\-nw** | \fB\-ne\fP | \fB\-sw\fP | \fB\-se\fP ] \fIgeometry\fP
.sp
xdeadzone \fB\-\-help\fP | \fB\-\-version\fP
.SH DESCRIPTION
@@ -50,8 +50,9 @@ resolution.
.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. Use \fB\-abs\fP (absolute positioning) mode for this,
-and either \fB\-b\fP or \fB\-w\fP to make the window visible.
+Adobe Reader. Use absolute positioning (no \fB\-nw\fP, \fB\-ne\fP, \fB\-sw\fP,
+\fB\-se\fP) for this, and either \fB\-b\fP or \fB\-w\fP to make the window
+visible.
.sp
By default, \fBxdeadzone\fP doesn\(aqt display a visible window. It stays
on top of other windows, and is present on every virtual desktop.
@@ -72,9 +73,23 @@ mouse from the wrong part of the screen.
.SH OPTIONS
.sp
Options can appear in any order on the command line.
+.SS Required argument
+.INDENT 0.0
+.TP
+.B \fBgeometry\fP
+This is a standard X11 geometry specification. Its format is
+<\fIwidth\fP>x<\fIheight\fP> for \fB\-nw\fP, \fB\-ne\fP, \fB\-sw\fP, \fB\-se\fP modes. For
+absolute positioning,
+it\(aqs <\fIwidth\fP>x<\fIheight\fP>[\fI+\-\fP]<\fIxpos\fP>[\fI+\-\fP]<\fIypos\fP>.
+Negative xpos and ypos will be
+treated as offsets from the right/bottom of the display.
+.sp
+Examples: \fB200x100\fP, \fB64x64\-0\-0\fP, \fB50x60+100+100\fP\&.
+.UNINDENT
.SS Modes
.sp
-One (and only one) mode option is required.
+One (and only one) mode option is allowed. If none is given,
+absolute positioning is used.
.INDENT 0.0
.TP
.B \fB\-nw\fP
@@ -88,31 +103,14 @@ Place window at southwest (bottom left) corner of display.
.TP
.B \fB\-se\fP
Place window at southeast (bottom right) corner of display.
-.TP
-.B \fB\-abs\fP
-Place window at the coordinates given by \fBgeometry\fP\&.
-.UNINDENT
-.SS Required argument
-.INDENT 0.0
-.TP
-.B \fBgeometry\fP
-This is a standard X11 geometry specification. Its format is
-<\fIwidth\fP>x<\fIheight\fP> for all modes other than \fB\-abs\fP\&. For \fB\-abs\fP,
-it\(aqs <\fIwidth\fP>x<\fIheight\fP>[\fI+\-\fP]<\fIxpos\fP>[\fI+\-\fP]<\fIypos\fP>.
-Negative xpos and ypos will be
-treated as offsets from the right/bottom of the display.
-.sp
-Examples: \fB200x100\fP, \fB64x64\-0\-0\fP, \fB50x60+100+100\fP\&.
.UNINDENT
.SS Appearance options
.sp
-These are optional, and control how \fBxdeadzone\fP\(aqs window will
-look and behave.
+These are optional, and control how \fBxdeadzone\fP\(aqs window will look
+and behave. By default, the window is invisible (\fIInputOnly\fP in Xlib
+terms).
.INDENT 0.0
.TP
-.B \fB\-i\fP
-Make window invisible. This is the default.
-.TP
.B \fB\-b\fP
Make window visible, display as a black rectangle.
.TP
@@ -122,7 +120,10 @@ Make window visible, display as a white rectangle.
.B \fB\-n\fP
Create window as a normal window, with titlebar and without
appearing on all desktops. Implies \fB\-w\fP, but can be followed
-by \fB\-b\fP for a black rectangle. Cannot be combined with \fB\-i\fP\&.
+by \fB\-b\fP for a black rectangle.
+In this mode, the window will have a titlebar (but no close button),
+will be movable and resizable, and will not appear on all virtual
+desktops. However, it will still be "always on top".
.UNINDENT
.SS Informational options
.INDENT 0.0