move actions to end of main loop

[xmenu] / xmenu.1

diff --git a/xmenu.1 b/xmenu.1
index f119efc..c2495a1 100644 (file)
--- a/xmenu.1
+++ b/xmenu.1
@@ -3,7 +3,7 @@
 xmenu \- menu utility for X
 .SH SYNOPSIS
 .B xmenu
 xmenu \- menu utility for X
 .SH SYNOPSIS
 .B xmenu

-.RB [ \-iw ]
+.RB [ \-irw ]

 .RB [ -p
 .IR position ]
 .RI [ title ]
 .RB [ -p
 .IR position ]
 .RI [ title ]


@@ -18,20 +18,45 @@ The options are as follows:
 .TP
 .B -i
 Disable icons.
 .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
 .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.
 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.
 .TP
 .B -w
 Asks the window manager to draw a border around the menus.


@@ -74,7 +99,14 @@ is controlled by the mouse,
 but can also be controlled by the keyboard.
 Items can be selected using the arrow keys,
 Tab (with and without Shift),
 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
 .BR Down ", " Tab
 Cycle through the items in the regular direction.


@@ -90,6 +122,10 @@ Go to the menu above.
 .TP
 .B Esc
 Go to the menu above or exit xmenu.
 .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
 .SH RESOURCES
 .B
 xmenu


@@ -97,6 +133,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.


@@ -130,6 +168,15 @@ The size in pixels of the border around the menu.
 .TP
 .B xmenu.separatorWidth
 The size in pixels of the item separator.
 .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
 
 .SH EXAMPLES
 The following script illustrates the use of