diff options
Diffstat (limited to 'xdeadzone.1')
-rw-r--r-- | xdeadzone.1 | 160 |
1 files changed, 160 insertions, 0 deletions
diff --git a/xdeadzone.1 b/xdeadzone.1 new file mode 100644 index 0000000..0e4a61d --- /dev/null +++ b/xdeadzone.1 @@ -0,0 +1,160 @@ +.\" Man page generated from reStructuredText. +. +. +.nr rst2man-indent-level 0 +. +.de1 rstReportMargin +\\$1 \\n[an-margin] +level \\n[rst2man-indent-level] +level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] +- +\\n[rst2man-indent0] +\\n[rst2man-indent1] +\\n[rst2man-indent2] +.. +.de1 INDENT +.\" .rstReportMargin pre: +. RS \\$1 +. nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin] +. nr rst2man-indent-level +1 +.\" .rstReportMargin post: +.. +.de UNINDENT +. RE +.\" indent \\n[an-margin] +.\" old: \\n[rst2man-indent\\n[rst2man-indent-level]] +.nr rst2man-indent-level -1 +.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]] +.in \\n[rst2man-indent\\n[rst2man-indent-level]]u +.. +.TH "XDEADZONE" 1 "2024-01-31" "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: +. +.\" rst2man.py xdeadzone.rst > xdeadzone.1 +. +.SH SYNOPSIS +.sp +xdeadzone [\fB\-nw\fP | \fB\-ne\fP | \fB\-sw\fP | \fB\-se\fP | \fB\-abs\fP \fIx\-position\fP \fIy\-position\fP] \fIwidth\fP \fIheight\fP +.sp +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. +.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. +.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. +.SH OPTIONS +.INDENT 0.0 +.TP +.B \-\-help +Print built\-in help message and exit. +.TP +.B \-\-version +Print the application name and version number, and exit. +.UNINDENT +.INDENT 0.0 +.TP +.B \fB\-nw\fP +Place window at northwest (top left) corner of display. +.TP +.B \fB\-ne\fP +Place window at northeast (top right) corner of display. +.TP +.B \fB\-sw\fP +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 \fIx\-position\fP \fIy\-position\fP +Place window at the given coordinates. Negative numbers will be +treated as offsets from the right/bottom of the display. +.TP +.B \fBwidth\fP +Width of the dead zone. Required; must be a positive integer. +.TP +.B \fBheight\fP +Height of the dead zone. Required; must be a positive integer. +.UNINDENT +.SH ENVIRONMENT +.INDENT 0.0 +.TP +.B \fBDISPLAY\fP +As usual for X applications: the X server to connect to. +.UNINDENT +.SH EXIT STATUS +.sp +With \fB\-\-help\fP or \fB\-\-version\fP, exit status is 0 (success). +.sp +If there\(aqs an error in the arguments, exit status is non\-zero (failure). +.sp +In normal operation, \fBxdeadzone\fP never exits. +.SH EXAMPLES +.sp +You have a 1920x1080 LCD monitor on the left, and a 1280x1024 +one on the right. This gives you a nice 3200x1080 X display... but the +mouse can "vanish", because X pretends the right\-hand monitor has +1080 vertical pixels. So there\(aqs a 1280x56 horizontal strip "below" the +bottom of the right\-hand monitor that doesn\(aqt get displayed. If the +mouse moves into this area, the pointer disappears, and it\(aqs not +obvious what happened to it. +.sp +To avoid losing the pointer, you can run this: +.INDENT 0.0 +.INDENT 3.5 +.sp +.nf +.ft C +xdeadzone \-se 1280 56 & +.ft P +.fi +.UNINDENT +.UNINDENT +.sp +\&...from your ~/.xinitrc (or whatever you use to run commands at X startup). +.sp +If you instead have the same two monitors in a vertical arrangement, +with the 1280x1024 one on top, you\(aqll have a 640x1024 vertical strip +of \(aqdead zone\(aq beyond the right edge of the top monitor. To avoid +losing the mouse there: +.INDENT 0.0 +.INDENT 3.5 +.sp +.nf +.ft C +xdeadzone \-ne 640 1024 & +.ft P +.fi +.UNINDENT +.UNINDENT +.sp +If the dead zone were on the left of the top monitor, you\(aqd use \fB\-nw\fP instead +of \fB\-ne\fP\&. +.SH BUGS +.sp +There isn\(aqt much error\-checking for the numeric arguments. Anything +non\-numeric will be read as zero. If you include a decimal point, +that should be an error, but instead it\(aqs silently ignored (the value +is truncated). +.sp +Maybe it should background (daemonize) itself. However, it works +fine with & to background it, and this is pretty common practice for +starting X software from ~/.xinitrc. +.SH COPYRIGHT +.sp +WTFPL. Do WTF you want to with this. +.sp +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). +.\" Generated by docutils manpage writer. +. |