1 MYMENU(1) - General Commands Manual
5 **mymenu** - simple menu for XOrg
11 utility a simple graphical menu for XOrg. It read the items from
13 and print the user selection to
21 > The first completion (if any) is always selected. This is like dmenu.
25 > Print a small usage message to stderr.
29 > Print version and exit.
33 The appearance of the menu is defined through the **X Resource**
38 > The font name to use. By default is set to "fixed" if compiled without
39 > Xft(3) support, "monospace" otherwise. Without Xft(3) only bitmap font
44 > The layout of the menu. The possible values are "horizontal" and
45 > "vertical", with the default being "horizontal". Every other value
46 > than "horizontal" is treated like "vertical", but this is kinda an
47 > implementation detail and not something to be relied on, since in the
48 > future other layout could be added as well.
52 > A string that is rendered before the user input. Default to "$ ".
56 > The width of the menu. If a numeric value is given (e.g. 400) is
57 > interpreted as pixel, if it ends with a percentage symbol \`%'
58 > (e.g. 40%) the relative percentage will be computed (relative to the
63 > The height of the menu. Like MyMenu.width if a numeric value is given
64 > is interpreted as pixel, if it ends with a percentage symbol \`%' the
65 > relative percentage will be computed (relative to the monitor height).
69 > The X coordinate of the topmost left corner of the window. Much like
70 > MyMenu.height and MyMenu.width both a pixel dimension and percentage
71 > could be supplied. In addition to it, the special value "middle" could
72 > be used: in that case the window will be centered on the x axes.
76 > The Y coordinate of the topmost left corner of the window. Like the X
77 > coordinate a pixel dimension, percentage dimension or the special
78 > value "middle" could be supplied.
82 > Change the padding. In the horizontal layout the padding is the space
83 > between the rectangle of the completion and the text as well as the
84 > space between the prompt and the first completion. In the horizontal
85 > layout the padding is the horizontal spacing between the window edge
86 > and the text as well as the space up and down the text within the
87 > completion. The default value is 10.
89 MyMenu.prompt.background
91 > The background of the prompt.
93 MyMenu.prompt.foreground
95 > The text color (foreground) of the prompt.
97 MyMenu.completion.background
99 > The background of the completions.
101 MyMenu.completion.foreground
103 > The text color of the completions.
105 MyMenu.completion\_highlighted.background
107 > The background of the selected completion.
109 MyMenu.completion\_highlighted.foreground
111 > The foreground of the selected completion.
115 This is the list of keybinding recognized by
117 In the following examples, C-c means Control-c.
121 > Close the menu without selecting any entry
129 > Close the menu and print to stdout what the user typed
137 > Expand the prompt to the next possible completion
141 > Expand the prompt to the previous possible completion
149 > The same as Shift-Tab
153 > Delete the last character
157 > The same as Backspace
161 > Delete the last word
165 > Delete the whole line
169 > Toggle the \`\`first selected'' style. Sometimes, especially with the -a
170 > option, could be handy to disable that behaviour. Let's say that
171 > you've typed \`\`fire'' and the first completion is \`\`firefox'' but you
172 > really want to choose \`\`fire''. While you can type some spaces, this
173 > keybinding is a more elegant way to change, at runtime, the behaviour
174 > of the first completion.
178 * If, instead of a numeric value, a not-valid number that terminates
179 with the % sign is supplied, then the default value for that field
180 will be treated as a percentage. Since this is a misuse of the
181 resources this behavior isn't strictly considered a bug.
183 * C-w (delete last word) does not work well with multi-byte string. The
184 whole UTF-8 support is still kinda naïve and should be improved.
188 0 when the user select an entry, 1 when the user press Esc, EX\_USAGE
189 if used with wrong flags and EX\_UNAVAILABLE if the connection to X
199 Omar Polo <omar.polo@europecom.net>
201 OpenBSD 6.3 - July 6, 2018