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