Add support for Home and End keys for moving
[xmenu] / xmenu.1
diff --git a/xmenu.1 b/xmenu.1
index 73a95f6..1e602df 100644 (file)
--- a/xmenu.1
+++ b/xmenu.1
@@ -4,6 +4,8 @@ xmenu \- menu utility for X
 .SH SYNOPSIS
 .B xmenu
 .RB [ \-iw ]
 .SH SYNOPSIS
 .B xmenu
 .RB [ \-iw ]
+.RB [ -p
+.IR position ]
 .RI [ title ]
 .SH DESCRIPTION
 .B xmenu
 .RI [ title ]
 .SH DESCRIPTION
 .B xmenu
@@ -16,12 +18,41 @@ The options are as follows:
 .TP
 .B -i
 Disable icons.
 .TP
 .B -i
 Disable icons.
+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[: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
 .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.
+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 -w
 Asks the window manager to draw a border around the menus.
 .TP
 .B -w
 Asks the window manager to draw a border around the menus.
@@ -87,6 +118,8 @@ understands the following X resources.
 .TP
 .B xmenu.font
 The font in which the labels should be drawn.
 .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.background
 The background color of non-selected items in the menu.