xmenu \- menu utility for X
.SH SYNOPSIS
.B xmenu
-.RB [ \-iw ]
+.RB [ \-irw ]
.RB [ -p
.IR position ]
.RI [ title ]
.TP
.B -i
Disable icons.
-.B xmenu
-allocates a space at the left side of the menu for the icons;
-if there is no icon, then this space will be blank.
-Setting the
-.B -i
-option removes this space, making the menu narrower.
+This makes xmenu loading faster when not using icons.
.TP
.BI -p " position"
Set the position to spawn xmenu.
Without this option, xmenu spawns next to the cursor.
.I position
is a string of the form
-.BR INTxINT ,
+.BR INTxINT[:MONITOR] ,
where the first INT is the x position and the second INT is the y position.
+The monitor part between brackets is optional.
+.B MONITOR
+can be a number from 0 to the number of monitors minus 1;
+or it can be a string like
+.B current
+or
+.BR cursor .
+If present, the monitor specifies that the position is relative to the upper left corner
+of that monitor.
+If
+.B monitor
+is
+.B current
+or
+.BR cursor ,
+the monitor to be used is that where the cursor is in.
+For example,
+.B -p 0x0:cursor
+specifies that
+.B xmenu
+must spawn at the position 0x0 of the monitor where the cursor is in.
+And
+.B -p 100x500:0
+specifies that
+.B xmenu
+must spawn at the position 100x500 of the monitor 0.
+.TP
+.B -r
+If this option is set, the right mouse button is disabled;
+so pressing it will not trigger any menu item.
.TP
.B -w
Asks the window manager to draw a border around the menus.
but can also be controlled by the keyboard.
Items can be selected using the arrow keys,
Tab (with and without Shift),
-Enter and Esc.
+Home, End,
+Enter and Esc, and 1-9 keys.
+.TP
+.BR Home
+Select the first item in the menu.
+.TP
+.BR End
+Select the last item in the menu.
.TP
.BR Down ", " Tab
Cycle through the items in the regular direction.
.TP
.B Esc
Go to the menu above or exit xmenu.
+.PP
+Additional key bindings can be set at compile time by changing the
+.B config.h
+file.
.SH RESOURCES
.B
xmenu
.TP
.B xmenu.font
The font in which the labels should be drawn.
+Multiple fonts can be added as fallback fonts;
+they must be separated by a comma.
.TP
.B xmenu.background
The background color of non-selected items in the menu.
.TP
.B xmenu.separatorWidth
The size in pixels of the item separator.
+.TP
+.B xmenu.alignment
+If set to
+.BR "\(dqleft\(dq" ,
+.BR "\(dqcenter\(dq" ,
+or
+.BR "\(dqright\(dq" ,
+text is aligned to the left, center, or right of the menu, respectively.
+By default, text is aligned to the left.
.SH EXAMPLES
The following script illustrates the use of