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