aboutsummaryrefslogtreecommitdiffstats
path: root/README.md
diff options
context:
space:
mode:
Diffstat (limited to 'README.md')
-rw-r--r--README.md31
1 files changed, 31 insertions, 0 deletions
diff --git a/README.md b/README.md
new file mode 100644
index 0000000..7f32fd8
--- /dev/null
+++ b/README.md
@@ -0,0 +1,31 @@
+# pointerlock
+
+## Description
+
+This patch keeps focus on a fullscreen client when the mouse pointer crosses
+a monitor edge. It applies to dwm 6.8.
+
+By default, `enternotify()` and `motionnotify()` change the selected monitor
+and focus whenever the pointer moves onto another monitor, so a fullscreen
+game loses focus from mouse movement alone. With this patch both handlers
+return early while a fullscreen client is selected. Keyboard focus changes,
+tag switching and `focusmon` still work.
+
+## Configuration
+
+The patch uses the existing `lockfullscreen` option in `config.h`. Set it to
+0 to disable the behaviour. No new options are added.
+
+## Testing
+
+Applies and builds against dwm 6.8. Runtime testing of the monitor crossing is
+pending; Xvfb would not provide two distinct Xinerama head positions on the
+development machine.
+
+## Download
+
+* [dwm-pointerlock-6.8.diff](dwm-pointerlock-6.8.diff)
+
+## Author
+
+* Daniel Guihot - [daniel@guihot.net](mailto:daniel@guihot.net)