|
0
|
1 .TH DMENU 1 dmenu\-VERSION |
|
|
2 .SH NAME |
|
|
3 dmenu \- dynamic menu |
|
|
4 .SH SYNOPSIS |
|
|
5 .B dmenu |
|
|
6 .RB [ \-bfiv ] |
|
|
7 .RB [ \-l |
|
|
8 .IR lines ] |
|
|
9 .RB [ \-m |
|
|
10 .IR monitor ] |
|
|
11 .RB [ \-p |
|
|
12 .IR prompt ] |
|
|
13 .RB [ \-fn |
|
|
14 .IR font ] |
|
|
15 .RB [ \-nb |
|
|
16 .IR color ] |
|
|
17 .RB [ \-nf |
|
|
18 .IR color ] |
|
|
19 .RB [ \-sb |
|
|
20 .IR color ] |
|
|
21 .RB [ \-sf |
|
|
22 .IR color ] |
|
|
23 .RB [ \-ob |
|
|
24 .IR color ] |
|
|
25 .RB [ \-of |
|
|
26 .IR color ] |
|
|
27 .RB [ \-w |
|
|
28 .IR windowid ] |
|
|
29 .P |
|
|
30 .BR dmenu_run " ..." |
|
|
31 .SH DESCRIPTION |
|
|
32 .B dmenu |
|
|
33 is a dynamic menu for X, which reads a list of newline\-separated items from |
|
|
34 stdin. When the user selects an item and presses Return, their choice is printed |
|
|
35 to stdout and dmenu terminates. Entering text will narrow the items to those |
|
|
36 matching the tokens in the input. |
|
|
37 .P |
|
|
38 .B dmenu_run |
|
|
39 is a script used by |
|
|
40 .IR dwm (1) |
|
|
41 which lists programs in the user's $PATH and runs the result in their $SHELL. |
|
|
42 .SH OPTIONS |
|
|
43 .TP |
|
|
44 .B \-b |
|
|
45 dmenu appears at the bottom of the screen. |
|
|
46 .TP |
|
|
47 .B \-f |
|
|
48 dmenu grabs the keyboard before reading stdin if not reading from a tty. This |
|
|
49 is faster, but will lock up X until stdin reaches end\-of\-file. |
|
|
50 .TP |
|
|
51 .B \-i |
|
|
52 dmenu matches menu items case insensitively. |
|
|
53 .TP |
|
|
54 .BI \-l " lines" |
|
|
55 dmenu lists items vertically, with the given number of lines. |
|
|
56 .TP |
|
|
57 .BI \-m " monitor" |
|
|
58 dmenu is displayed on the monitor number supplied. Monitor numbers are starting |
|
|
59 from 0. |
|
|
60 .TP |
|
|
61 .BI \-p " prompt" |
|
|
62 defines the prompt to be displayed to the left of the input field. |
|
|
63 .TP |
|
|
64 .BI \-fn " font" |
|
|
65 defines the font or font set used. |
|
|
66 .TP |
|
|
67 .BI \-nb " color" |
|
|
68 defines the normal background color. |
|
|
69 .IR #RGB , |
|
|
70 .IR #RRGGBB , |
|
|
71 and X color names are supported. |
|
|
72 .TP |
|
|
73 .BI \-nf " color" |
|
|
74 defines the normal foreground color. |
|
|
75 .TP |
|
|
76 .BI \-sb " color" |
|
|
77 defines the selected background color. |
|
|
78 .TP |
|
|
79 .BI \-sf " color" |
|
|
80 defines the selected foreground color. |
|
|
81 .TP |
|
|
82 .BI \-ob " color" |
|
|
83 defines the outline background color (for multiple selection). |
|
|
84 .TP |
|
|
85 .BI \-of " color" |
|
|
86 defines the outline foreground color (for multiple selection). |
|
|
87 .TP |
|
|
88 .B \-v |
|
|
89 prints version information to stdout, then exits. |
|
|
90 .TP |
|
|
91 .BI \-w " windowid" |
|
|
92 embed into windowid. |
|
|
93 .SH USAGE |
|
|
94 dmenu is completely controlled by the keyboard. Items are selected using the |
|
|
95 arrow keys, page up, page down, home, and end. |
|
|
96 .TP |
|
|
97 .B Tab |
|
|
98 Copy the selected item to the input field. |
|
|
99 .TP |
|
|
100 .B Return |
|
|
101 Confirm selection. Prints the selected item to stdout and exits, returning |
|
|
102 success. |
|
|
103 .TP |
|
|
104 .B Ctrl-Return |
|
|
105 Confirm selection. Prints the selected item to stdout and continues. |
|
|
106 .TP |
|
|
107 .B Shift\-Return |
|
|
108 Confirm input. Prints the input text to stdout and exits, returning success. |
|
|
109 .TP |
|
|
110 .B Escape |
|
|
111 Exit without selecting an item, returning failure. |
|
|
112 .TP |
|
|
113 .B Ctrl-Left |
|
|
114 Move cursor to the start of the current word |
|
|
115 .TP |
|
|
116 .B Ctrl-Right |
|
|
117 Move cursor to the end of the current word |
|
|
118 .TP |
|
|
119 .B C\-a |
|
|
120 Home |
|
|
121 .TP |
|
|
122 .B C\-b |
|
|
123 Left |
|
|
124 .TP |
|
|
125 .B C\-c |
|
|
126 Escape |
|
|
127 .TP |
|
|
128 .B C\-d |
|
|
129 Delete |
|
|
130 .TP |
|
|
131 .B C\-e |
|
|
132 End |
|
|
133 .TP |
|
|
134 .B C\-f |
|
|
135 Right |
|
|
136 .TP |
|
|
137 .B C\-g |
|
|
138 Escape |
|
|
139 .TP |
|
|
140 .B C\-h |
|
|
141 Backspace |
|
|
142 .TP |
|
|
143 .B C\-i |
|
|
144 Tab |
|
|
145 .TP |
|
|
146 .B C\-j |
|
|
147 Return |
|
|
148 .TP |
|
|
149 .B C\-J |
|
|
150 Shift-Return |
|
|
151 .TP |
|
|
152 .B C\-k |
|
|
153 Delete line right |
|
|
154 .TP |
|
|
155 .B C\-m |
|
|
156 Return |
|
|
157 .TP |
|
|
158 .B C\-M |
|
|
159 Shift-Return |
|
|
160 .TP |
|
|
161 .B C\-n |
|
|
162 Down |
|
|
163 .TP |
|
|
164 .B C\-p |
|
|
165 Up |
|
|
166 .TP |
|
|
167 .B C\-u |
|
|
168 Delete line left |
|
|
169 .TP |
|
|
170 .B C\-w |
|
|
171 Delete word left |
|
|
172 .TP |
|
|
173 .B C\-y |
|
|
174 Paste from primary X selection |
|
|
175 .TP |
|
|
176 .B C\-Y |
|
|
177 Paste from X clipboard |
|
|
178 .TP |
|
|
179 .B M\-b |
|
|
180 Move cursor to the start of the current word |
|
|
181 .TP |
|
|
182 .B M\-f |
|
|
183 Move cursor to the end of the current word |
|
|
184 .TP |
|
|
185 .B M\-g |
|
|
186 Home |
|
|
187 .TP |
|
|
188 .B M\-G |
|
|
189 End |
|
|
190 .TP |
|
|
191 .B M\-h |
|
|
192 Up |
|
|
193 .TP |
|
|
194 .B M\-j |
|
|
195 Page down |
|
|
196 .TP |
|
|
197 .B M\-k |
|
|
198 Page up |
|
|
199 .TP |
|
|
200 .B M\-l |
|
|
201 Down |
|
|
202 .SH SEE ALSO |
|
|
203 .IR dwm (1), |
|
|
204 .IR stest (1) |