Module Name: src
Committed By: nat
Date: Mon Jan 20 16:06:01 UTC 2025
Modified Files:
src/share/man/man4: akbd.4
Log Message:
Add example to use xmodmap to remap Option to Command key.
Clarification on keys that generate middle and right button events.
Clarification for brightness keys on mac68k.
Addresses PR/59011.
To generate a diff of this commit:
cvs rdiff -u -r1.2 -r1.3 src/share/man/man4/akbd.4
Please note that diffs are not public domain; they are subject to the
copyright notices on the relevant files.
Modified files:
Index: src/share/man/man4/akbd.4
diff -u src/share/man/man4/akbd.4:1.2 src/share/man/man4/akbd.4:1.3
--- src/share/man/man4/akbd.4:1.2 Tue Oct 29 01:44:25 2024
+++ src/share/man/man4/akbd.4 Mon Jan 20 16:06:01 2025
@@ -1,4 +1,4 @@
-.\" $NetBSD: akbd.4,v 1.2 2024/10/29 01:44:25 nat Exp $
+.\" $NetBSD: akbd.4,v 1.3 2025/01/20 16:06:01 nat Exp $
.\"
.\" Copyright (c) 2003 Alex Zepeda <zipzi...@sonic.net>
.\" All rights reserved.
@@ -28,7 +28,7 @@
.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
.\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
.\"
-.Dd October 28, 2024
+.Dd January 20, 2025
.Dt AKBD 4
.Os
.Sh NAME
@@ -48,6 +48,13 @@ driver with support for Apple Desktop Bu
.Pp
To work around the limited number of buttons found on most ADB mice,
one can map key sequences to trigger mouse button events.
+.Bl
+.It
+Option+LeftArrow will work as the middle mouse button.
+.It
+Option+RightArrow will work as the right mouse button.
+.El
+.Pp
To map Option+1, Option+2, Option+3 to mouse buttons 1, 2, and 3
respectively, add the following line to your kernel configuration
file:
@@ -72,7 +79,7 @@ events, place the following line in your
.Pp
.Cd options FORCE_FUNCTION_KEYS
.Pp
-On PowerBook models holding Option and up/down arrows change the screen
+On PowerBook (mac68k) models holding Option and up/down arrows change the screen
brightness.
.Sh SUPPORTED HARDWARE
.Nx
@@ -99,10 +106,22 @@ Most third-party ADB keyboards are suppo
.Xr adb 4 ,
.Xr wscons 4 ,
.Xr wskbd 4 ,
-.Xr wsconsctl 8
+.Xr wsconsctl 8 ,
+.Xr xmodmap 1
.Sh BUGS
The number pad on extended keyboards does not send out the proper
key codes for many applications.
.Pp
The LEDs on extended keyboards are not functional under
.Nx .
+.Pp
+In X11 with the default key mapping, middle and right mouse button events will
+hold Meta_L and this will clobber the intended mouse button.
+.Pp
+Meta_L shoud be remapped with
+.Xr xmodmap 1
+to the Command Key ie:
+.Pp
+.Dl remove Mod4 = Super_L
+.Dl remove Mod1 = Alt_L
+.Dl add Mod1 = Super_L
