Added support for fallback fonts.

[xmenu] / xmenu.1

diff --git a/xmenu.1 b/xmenu.1
index 1aa2434..d87ba4b 100644 (file)
--- a/xmenu.1
+++ b/xmenu.1
@@ -1,9 +1,11 @@
-.TH PROG 1
+.TH XMENU 1
 .SH NAME
 xmenu \- menu utility for X
 .SH SYNOPSIS
 .B xmenu
-.RB [ \-w ]
+.RB [ \-iw ]
+.RB [ -p
+.IR position ]
 .RI [ title ]
 .SH DESCRIPTION
 .B xmenu
@@ -14,9 +16,27 @@ and outputs the item selected to stdout.
 .PP
 The options are as follows:
 .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.
+.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 ,
+where the first INT is the x position and the second INT is the y position.
+.TP
 .B -w
 Asks the window manager to draw a border around the menus.
-This option may be buggy in some window managers, specially tiled ones.
+This option may be buggy in some window managers,
+specially tiled ones that do not respect window hints.
 .PP
 Each item read from stdin has the following format:
 .IP
@@ -77,30 +97,35 @@ understands the following X resources.
 .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 itens in the menu.
+The background color of non-selected items in the menu.
 .TP
 .B xmenu.foreground
-The color of the label text of non-selected itens in the menu.
+The color of the label text of non-selected items in the menu.
 .TP
 .B xmenu.selbackground
-The background color of selected itens in the menu.
+The background color of selected items in the menu.
 .TP
 .B xmenu.selforeground
-The color of the label text of selected itens in the menu.
+The color of the label text of selected items in the menu.
 .TP
 .B xmenu.border
 The color of the border around the menu.
 .TP
 .B xmenu.separator
-The color of the separator between itens in the menu.
+The color of the separator between items in the menu.
+.TP
+.B xmenu.gap
+The gap, in pixels, between the menus.
 .TP
 .B xmenu.width
 The minimum width, in pixels, of the items in the menu.
 .TP
-.B xmenu.padding
-The size in pixels of the padding around the label text in items in the menu.
+.B xmenu.height
+The size in pixels of the height of a single menu item.
 .TP
 .B xmenu.borderWidth
 The size in pixels of the border around the menu.
@@ -109,7 +134,7 @@ The size in pixels of the border around the menu.
 The size in pixels of the item separator.
 
 .SH EXAMPLES
-The following is an script exemplifying the use of
+The following script illustrates the use of
 .BR xmenu .
 The output is redirected to
 .IR sh (1),
@@ -121,7 +146,7 @@ creating a command to be run by the shell.
 cat <<EOF | xmenu | sh &
 Applications
        IMG:./web.png   Web Browser     firefox
-       Image editor                            gimp
+       IMG:./gimp.png  Image editor    gimp
 Terminal (xterm)                               xterm
 Terminal (urxvt)                               urxvt
 Terminal (st)                                  st
@@ -132,7 +157,7 @@ EOF
 .EE
 .PP
 For example, by selecting \(lqApplications\(rq, a new menu will appear.
-Selecting \(lqWeb Browser\(rq in the new menu will open firefox.
+Selecting \(lqWeb Browser\(rq in the new menu opens firefox.
 .SH SEE ALSO
 .IR dmenu (1),
 .IR 9menu (1),