1.TH GRIDMENU 1 grid-0.0
 2.SH NAME
 3gridmenu \- grid window manager menu
 4.SH SYNOPSIS
 5.B gridmenu
 6.RB [ \-v ]
 7.RB [ \-t
 8.IR title ]
 9.SH DESCRIPTION
10.SS Overview
11.B gridmenu
12is a generic, highly customizable, and efficient menu for the X Window System,
13originally designed for
14.BR grid (1).
15It supports arbitrary, user defined menu contents.
16.SS Options
17.TP
18.B \-v
19prints version information to stdout, then exits.
20.TP
21.BI \-t " title"
22displays
23.I title
24above the menu.
25.SS Usage
26.B gridmenu
27reads a list of newline-separated items from stdin and creates a menu.
28When the user selects an item or enters any text and presses Enter, his choice
29is printed to stdout and
30.B gridmenu
31terminates.
32.SS Keyboard Control 
33.B gridmenu
34is completely controlled by the keyboard.  The following keys are recognized:
35.TP 2
36Any printable character
37appends the character to the text in the input field. This works as a filter:
38only items containing this text will be displayed.
39.TP 2
40Left/Right (Control-p/Control-n)
41select the previous/next item.
42.TP 2
43Tab (Control-i)
44copy the selected item to the input field.
45.TP 2
46Enter (Control-j)
47confirm selection and quit (print the selected item to stdout).
48.TP 2
49Shift-Enter (Shift-Control-j)
50confirm selection and quit (print the text in the input field to stdout).
51.TP 2
52Escape (Control-[)
53quit without selecting an item.
54.TP 2
55Backspace (Control-h)
56remove enough characters from the input field to change its filtering effect.
57.TP 2
58Control-u
59remove all characters from the input field.
60.SS Exit codes
61.B gridmenu
62returns
63.B 0
64if Enter is pressed on termination,
65.B 1
66if Escape is pressed.
67.SH SEE ALSO
68.BR gridwm (1)