summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorBjarni Ingi Gislason <bjarniig@simnet.is>2025-01-27 02:56:28 +0000
committerAlan Coopersmith <alan.coopersmith@oracle.com>2025-04-17 16:21:51 -0700
commit506799613210b64cb8175468fa5dd8b0cc2ddd9c (patch)
tree2b404dadea3c07816e73e25a23b5dbe771e88116
parent4a6c7c88ae7eea7003cb37385c87c83ec1355f2a (diff)
xmodmap.1: Some editorial changes for this man page [Debian bug #1094313]HEADmaster
Originally from https://bugs.debian.org/1094313 Signed-off-by: Alan Coopersmith <alan.coopersmith@oracle.com> Part-of: <https://gitlab.freedesktop.org/xorg/app/xmodmap/-/merge_requests/9>
-rw-r--r--man/xmodmap.man18
1 files changed, 6 insertions, 12 deletions
diff --git a/man/xmodmap.man b/man/xmodmap.man
index e7d3ccf..43db764 100644
--- a/man/xmodmap.man
+++ b/man/xmodmap.man
@@ -63,7 +63,6 @@ xmodmap - utility for modifying keymaps and pointer button mappings in X
.B xmodmap
[\fI\-options\fP ...] [\fIfilename\fP]
.SH DESCRIPTION
-.PP
The \fBxmodmap\fP program is used to edit and display the
keyboard \fImodifier map\fP and \fIkeymap table\fP that are used by client
applications to convert event keycodes into keysyms.
@@ -77,7 +76,6 @@ desktop environment preferences,
or the use of commands such as
.BR setxkbmap (__appmansuffix__).
.SH OPTIONS
-.PP
The following options may be used with \fBxmodmap\fP:
.TP 8
.B \-display \fIdisplay\fP
@@ -87,7 +85,7 @@ This option specifies the host and display to use.
This option indicates that a brief description of the command line arguments
should be printed on the standard error channel.
This will be done whenever an unhandled argument is given to
-.B xmodmap.
+.BR xmodmap .
.TP 8
.B \-grammar
This option indicates that a help message describing the expression grammar
@@ -143,7 +141,6 @@ to be executed.
This file is usually kept in the user's home directory with a name like
\fB.xmodmaprc\fP.
.SH EXPRESSION GRAMMAR
-.PP
The
.B xmodmap
program reads a list of expressions and parses them all before attempting
@@ -227,7 +224,6 @@ Lines that begin with an exclamation point (!) are taken as comments.
If you want to change the binding of a modifier key, you must also remove it
from the appropriate modifier map.
.SH EXAMPLES
-.PP
Many pointers are designed such that the first button is pressed using the
index finger of the right hand.
People who are left-handed frequently find that it is more comfortable to
@@ -235,7 +231,7 @@ reverse the button codes that get generated
so that the primary button is pressed using the index finger of the left hand.
This could be done on a 3 button pointer as follows:
.EX
-% xmodmap -e "pointer = 3 2 1"
+% xmodmap \-e "pointer = 3 2 1"
.EE
.PP
Many applications support the notion of Meta keys
@@ -250,13 +246,13 @@ first column of the keymap table.
This means that applications that are looking for a Multi_key (including the
default modifier map) won't notice any change.
.EX
-% xmodmap -e "keysym Multi_key = Multi_key Meta_L"
+% xmodmap \-e "keysym Multi_key = Multi_key Meta_L"
.EE
.PP
Similarly, some keyboards have an Alt key but no Meta key.
In that case the following may be useful:
.EX
-% xmodmap -e "keysym Alt_L = Meta_L Alt_L"
+% xmodmap \-e "keysym Alt_L = Meta_L Alt_L"
.EE
.PP
One of the more simple, yet convenient, uses of \fBxmodmap\fP is to set the
@@ -268,8 +264,8 @@ If the \fBttyModes\fP resource in
is set as well,
all terminal emulator windows will use the same key for erasing characters:
.EX
-% xmodmap -e "keysym BackSpace = Delete"
-% echo "XTerm*ttyModes: erase ^?" | xrdb -merge
+% xmodmap \-e "keysym BackSpace = Delete"
+% echo "XTerm*ttyModes: erase ^?" | xrdb \-merge
.EE
.PP
Some keyboards do not automatically generate less than and greater than
@@ -331,7 +327,6 @@ keycode 15 = Caps_Lock
add Lock = Caps_Lock
.EE
.SH ENVIRONMENT
-.PP
.TP 8
.B DISPLAY
to get default host and display number.
@@ -342,7 +337,6 @@ to get default host and display number.
.BR XStringToKeysym (__libmansuffix__),
\fIXlib\fP documentation on key and pointer events
.SH BUGS
-.PP
Every time a \fBkeycode\fP expression is evaluated,
the server generates a \fBMappingNotify\fP event on every client.
This can cause some thrashing.