aboutsummaryrefslogtreecommitdiff
path: root/jsmond.1
diff options
context:
space:
mode:
authorB. Watson <yalhcru@gmail.com>2020-05-18 23:59:51 -0400
committerB. Watson <yalhcru@gmail.com>2020-05-18 23:59:51 -0400
commit005fc7dcf69fc112b5ce3d2c4017769cd8e425e8 (patch)
tree88b902b56f30ed80e4ffd0f7dbeeaf62da6cfcaf /jsmond.1
parent045f4601b352abc2955050bd273b46ad602f3bad (diff)
downloadunsaver-005fc7dcf69fc112b5ce3d2c4017769cd8e425e8.tar.gz
detect fullscreen windows (-f/-F)
Diffstat (limited to 'jsmond.1')
-rw-r--r--jsmond.120
1 files changed, 13 insertions, 7 deletions
diff --git a/jsmond.1 b/jsmond.1
index fc761bc..8b9513b 100644
--- a/jsmond.1
+++ b/jsmond.1
@@ -36,11 +36,12 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
.
.SH SYNOPSIS
.sp
-jsmond [\fB\-i interval[s|ms]\fP] [\fB\-m\fP | \fB\-k keycode\fP | \fB\-b button\fP] [\fB\-d dir\fP] [\fB\-j name\fP] [\fB\-D\fP] [\fBjoydev [joydev ...]\fP]
+jsmond [\fB\-i interval[s|ms]\fP] [\fB\-m\fP | \fB\-k keycode\fP | \fB\-b button\fP | \fB\-c command\fP | \fB\-x\fP ] [\fB\-d dir\fP] [\fB\-j name\fP] [\fB\-f\fP] [\fB\-F\fP] [\fB\-D\fP] [\fBjoydev [joydev ...]\fP]
.SH DESCRIPTION
.sp
-jsmond lets you play games with your joysticks/gamepads without
-the screen saver activating due to lack of keyboard/mouse input.
+jsmond lets you play games with your joysticks/gamepads without the screen
+saver activating due to lack of keyboard/mouse input. It can also prevent
+the screensaver from activating when a fullscreen window is in use.
.sp
Multiple joystick devices can be monitored. By default, jsmond
monitors up to 16 devices, named /dev/input/js0 through js15.
@@ -96,18 +97,20 @@ to its starting point.
.BI \-c \ <command>
Run a command when activity is detected, rather than
sending a fake keystroke/click/motion. It\(aqs recommended
-to set \fIinterval\fP to at least 1 second, when using this
-option.
+to set \fIinterval\fP to at least 1 second when using this
+option, to avoid excess process\-spawning overhead.
.TP
.B \-x
Same as \fB\-c "xscreensaver\-command \-deactivate" \-i 1s\fP\&.
.TP
.B \-f
-Disable screensaver if a full\-screen window is detected.
-This isn\(aqt likely to be 100% reliable.
+Deactivate screensaver if a fullscreen window is detected.
+This isn\(aqt likely to be 100% reliable yet.
.TP
.B \-F
Same as \fB\-f\fP, but also disables joystick monitoring entirely.
+Note that \fB\-j\fP, \fB\-d\fP, and \fBjoydev\fP are ignored
+with this option.
.UNINDENT
.sp
These options are intended for developers and \fIreally\fP shouldn\(aqt be
@@ -157,6 +160,9 @@ password dialog, same as pressing a key or mouse button would.
jsmond depends on the XTest extension being present in the X server. If
you get a "X server doesn\(aqt support XTest extension" error, see your X
server documentation to find out how to enable XTest.
+.sp
+The fullscreen window monitoring has only been tested on a system with
+a single monitor, and may not work properly in multi\-head environments.
.SH EXIT STATUS
.sp
Without the \-D option, the exit status is 0 (success) if jsmond