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.layout
26 The layout of the menu. The possible values are "horizontal" and
27 "vertical", with the default being "horizontal". Every other value
28 than "horizontal" is treated like "vertical", but this is kinda an
29 implementation detail and not something to be relied on, since in the
30 future other layout could be added as well
31 .It MyMenu.width
32 The width of the menu. If a numeric value is given (e.g. 400) is
33 interpreted as pixel, if it ends with a percentage symbol `%'
34 (e.g. 40%) the relative percentage will be computed (relative to the
35 monitor width)
36 .It MyMenu.height
37 The height of the menu. Like MyMenu.width if a numeric value is given
38 is interpreted as pixel, if it ends with a percentage symbol `%' the
39 relative percentage will be computed (relative to the monitor height)
40 .It MyMenu.x
41 The X coordinate of the topmost left corner of the window. Much like
42 MyMenu.height and MyMenu.width both a pixel dimension and percentage
43 could be supplied. In addition to it, the special value "middle" could
44 be used: in that case the window will be centered on the x axes.
45 .It MyMenu.y
46 The Y coordinate of the topmost left corner of the window. Like the X
47 coordinate, pixel dimension, percentage dimension and the special
48 value "middle" could be supplied.
49 .It MyMenu.prompt.background
50 The background of the prompt
51 .It MyMenu.prompt.foreground
52 The text color (foreground) of the prompt
53 .It MyMenu.completion.background
54 The background of the completions
55 .It MyMenu.completion.foreground
56 The text color of the completions
57 .It MyMenu.completion_highlighted.background
58 The background of the selected completion
59 .It MyMenu.completion_highlighted.foreground
60 The foreground of the selected completion
61 .El
62 
63 .Sh KEYS
64 .Bl -tag -width indent-two
65 .It Esc
66 Close the menu without selecting any entry
67 .It Enter
68 Close the menu and print to stdout what the user typed
69 .It C-m
70 The same as Enter
71 .It Tab
72 Expand the prompt to the next possible completion
73 .It Shift Tab
74 Expand the prompt to the previous possible completion
75 .It Backspace
76 Delete the last character
77 .It C-h
78 The same as Backspace
79 .It C-w
80 Delete the last word
81 .It C-u
82 Delete the whole line
83 .El
84 
85 .Sh BUGS
86 .Bl -bullet
87 .It
88 If, instead of a numeric value, a not-valid number that terminates
89 with the % sign is supplied, then the default value for that field
90 will be treated as a percentage. Since this is a misuse of the
91 resources this behavior isn't strictly considered a bug.
92 .El
93 
94 .Sh EXIT STATUS
95 
96 0 when the user select an entry, 1 when the user press Esc and
97 EX_UNAVAILABLE if the connection to X fails.
98 
99 .Sh SEE ALSO
100 .Xr dmenu 1
101 .Xr sysexits 3
102 
103 .Sh AUTHORS
104 .An Omar Polo <omar.polo@europecom.net>
105