mention udev rules in man page, add LIMITATIONS.

1 files changed, 27 insertions, 1 deletions

diff --git a/marsond.8 b/marsond.8
index be63471..ecd7145 100644
--- a/marsond.8
+++ b/marsond.8
@@ -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 "MARSOND" 8 "2025-05-07" "0.3.0" "Urchlay's Stuff"
+.TH "MARSOND" 8 "2025-05-08" "0.3.0" "Urchlay's Stuff"
 .SH NAME
 marsond \- Fix Enter key timing on Marson/USBLink/MT606-1 PS/2-USB adaptors
 .SH SYNOPSIS
@@ -72,6 +72,18 @@ does, with SDL 1 and 2 running under X (and SDL 1 on the console,
 too). I don\(aqt use Wayland, so I haven\(aqt tested it there. If you do,
 please contact me and let me know if it works for you.
 .sp
+For normal use, \fBmarsond\fP will be started by a \fBudev\fP(7) rule
+when the adaptor is plugged in (including booting with the adaptor
+connected). The udev rule is found in:
+.INDENT 0.0
+.INDENT 3.5
+/etc/udev/rules.d/99\-marsond.rules
+.UNINDENT
+.UNINDENT
+.sp
+\&...which can be edited to change the options it\(aqs run with, if
+needed. The defaults work well on the author\(aqs system.
+.sp
 \fBmarsond\fP must be run as root. At startup, it does these
 things as root:
 .INDENT 0.0
@@ -165,6 +177,20 @@ Group to run as, after dropping privileges. Default:
 the primary group of the user it\(aqs running as. Normally
 you won\(aqt have to set this.
 .UNINDENT
+.SH LIMITATIONS
+.sp
+Only one MT\-606\-1 device is supported, out of the box. This shouldn\(aqt
+really be a problem (do you really need 2 keyboards?) but it\(aqs worth
+mentioning. If you really do own two of these adaptors and want to use
+them on the same PC, you could add a second udev rule (with \-k option
+for the daemon).
+.sp
+This isn\(aqt really a \fBmarsond\fP problem per se, but when Xorg detects
+a new keyboard, it resets your keyboard repeat rate (\fBxset r\fP)
+and custom keymap (\fBxmodmap\fP(1)). If you use a \(aqdesktop\(aq such
+as KDE, GNOME, or XFCE, it should re\-apply your settings. For a
+traditional window manager (WindowMaker, FVWM2, etc), this can be very
+annoying.
 .\" EXIT STATUS
 .
 .\" ===========