1 .Dd $Mdocdate$
2 .Dt MYMENU 1
3 .Os
4 .Sh NAME
5 .Nm mymenu
6 .Nd simple menu for XOrg
7 .Sh DESCRIPTION
8 The
9 .Nm
10 utility a simple graphical menu for XOrg. It read the items from
11 .Ic stdin
12 and print the user selection to
13 .Ic stdout
14 on exit.
15 .Sh RESOURCES
16 
17 Most of the appearance of the menu is defined through the \fBX
18 Resource Database\fR.
19 
20 Application specific resources:
21 .Bl -tag -width Ds
22 .It MyMenu.font
23 The font name, only bitmap font are supported. By default is set to
24 "fixed"
25 .It MyMenu.width
26 The width of the menu. If a numeric value is given (e.g. 400) is
27 interpreted as pixel, if it ends with a percentage symbol `%'
28 (e.g. 40%) the relative percentage will be computed (relative to the
29 monitor width)
30 .It MyMenu.height
31 The height of the menu. Like MyMenu.width if a numeric value is given
32 is interpreted as pixel, if it ends with a percentage symbol `%' the
33 relative percentage will be computed (relative to the monitor height)
34 .It MyMenu.x
35 The X coordinate of the topmost left corner of the window. Much like
36 MyMenu.height and MyMenu.width both a pixel dimension and percentage
37 could be supplied. In addition to it, the special value "middle" could
38 be used: in that case the window will be centered on the x axes.
39 .It MyMenu.y
40 The Y coordinate of the topmost left corner of the window. Like the X
41 coordinate, pixel dimension, percentage dimension and the special
42 value "middle" could be supplied.
43 .It MyMenu.prompt.background
44 The background of the prompt
45 .It MyMenu.prompt.foreground
46 The text color (foreground) of the prompt
47 .It MyMenu.completion.background
48 The background of the completions
49 .It MyMenu.completion.foreground
50 The text color of the completions
51 .It MyMenu.completion_highlighted.background
52 The background of the selected completion
53 .It MyMenu.completion_highlighted.foreground
54 The foreground of the selected completion
55 .El
56 
57 .Sh KEYS
58 .Bl -tag -width indent-two
59 .It Esc
60 Close the menu without selecting any entry
61 .It Enter
62 Close the menu and print to stdout what the user typed
63 .It Tab
64 Expand the prompt to the next possible completion
65 .It Shift Tab
66 Expand the prompt to the previous possible completion
67 .It Backspace
68 Delete the last character
69 .El
70 
71 .Sh BUGS
72 .Bl -bullet
73 .It
74 Shift tab is currently broken
75 .It
76 If, instead of a numeric value, a not-valid number that terminates
77 with the % sign is supplied, then the default value for that field
78 will be treated as a percentage. Since this is a misuse of the
79 resources this behavior isn't strictly considered a bug.
80 .El
81 
82 .Sh EXIT STATUS
83 
84 0 when the user select an entry, 1 when the user press Esc and
85 EX_UNAVAILABLE if the connection to X fails.
86 
87 .Sh SEE ALSO
88 .Xr dmenu 1
89 .Xr sysexits 3
90 
91 .Sh AUTHORS
92 .An Omar Polo <omar.polo@europecom.net>
93