Make xmenu wait for another process to ungrab

[xmenu] / xmenu.1

diff --git a/xmenu.1 b/xmenu.1
index de61a9e..7764afd 100644 (file)
--- a/xmenu.1
+++ b/xmenu.1
@@ -4,6 +4,7 @@ xmenu \- menu utility for X
 .SH SYNOPSIS
 .B xmenu
 .RB [ \-w ]
 .SH SYNOPSIS
 .B xmenu
 .RB [ \-w ]

+.RI [ title... ]

 .SH DESCRIPTION
 .B xmenu
 is a menu for X,
 .SH DESCRIPTION
 .B xmenu
 is a menu for X,


@@ -35,8 +36,35 @@ An item without label is considered a separator and is drawn as a thin line in t
 separating the item above from the item below.
 .IP
 The command is the string that will be output after selecting the item.
 separating the item above from the item below.
 .IP
 The command is the string that will be output after selecting the item.

+If the item spawns a submenu, the command is the title of the menu.

 .IP
 The newline terminates the item specification.
 .IP
 The newline terminates the item specification.

+.PP
+If the argument
+.I title
+is given, the title of the menu window is set to it.
+.SH USAGE
+.B xmenu
+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),
+Enter and Esc.
+.TP
+.BR Down ", " Tab
+Cycle through the items in the regular direction.
+.TP
+.BR Up ", " Shift-Tab
+Cycle through the items in the reverse direction.
+.TP
+.BR Right ", " Enter
+Select the highlighted item.
+.TP
+.B Left
+Go to the menu above.
+.TP
+.B Esc
+Go to the menu above or exit xmenu.

 .SH RESOURCES
 .B
 xmenu
 .SH RESOURCES
 .B
 xmenu


@@ -76,14 +104,16 @@ The size in pixels of the border around the menu.
 The size in pixels of the item separator.
 
 .SH EXAMPLES
 The size in pixels of the item separator.
 
 .SH EXAMPLES

-The following is an script exemplifying the use
+The following is an script exemplifying the use of

 .BR xmenu .
 .BR xmenu .

-The output is redirected to xargs to make a command to be run by the shell.
+The output is redirected to
+.IR sh (1),
+creating a command to be run by the shell.

 .IP
 .EX
 #!/bin/sh
 
 .IP
 .EX
 #!/bin/sh
 

-cat <<EOF | ./xmenu | xargs sh -c
+cat <<EOF | xmenu | sh

 Applications
        Web Browser     firefox
        Image editor    gimp
 Applications
        Web Browser     firefox
        Image editor    gimp