diff options
Diffstat (limited to 'dmenu.1')
| -rw-r--r-- | dmenu.1 | 46 |
1 files changed, 20 insertions, 26 deletions
@@ -14,12 +14,22 @@ dmenu \- dynamic menu .RB [ \-sb " <color>]" .RB [ \-sf " <color>]" .RB [ \-v ] + +.B dmenu_run +[<options...>] + +.BR dmenu_path .SH DESCRIPTION .SS Overview dmenu is a generic menu for X, originally designed for .BR dwm (1). It manages huge amounts (up to 10.000 and more) of user defined menu items efficiently. + +dmenu_run is a dmenu script used by dwm which lists executables in the user's PATH +and executes the selected item. + +dmenu_path is a script used by dmenu_run to find and cache a list of executables. .SS Options .TP .B \-i @@ -33,7 +43,7 @@ reparents dmenu to the window specified by xid. .TP .B \-l <lines> activates vertical list mode. -The given number of lines will be displayed. Window height will get adjusted. +The given number of lines will be displayed. Window height will be adjusted. .TP .B \-fn <font> defines the font. @@ -60,20 +70,9 @@ dmenu reads a list of newline-separated items from standard input and creates a menu. When the user selects an item or enters any text and presses Return, his/her choice is printed to standard output and dmenu terminates. .P -dmenu is completely controlled by the keyboard. The following keys are recognized: -.TP -.B Any printable character -Appends the character to the text in the input field. This works as a filter: -only items containing this text will be displayed. -.TP -.B Left/Right (Up/Down) (Mod1\-h/Mod1\-l) -Select the previous/next item. -.TP -.B PageUp/PageDown (Mod1\-k/Mod1\-j) -Select the first item of the previous/next 'page' of items. -.TP -.B Home/End (Mod1\-g/Mod1\-G) -Select the first/last item. +dmenu is completely controlled by the keyboard. Besides standard Unix line editing, +and item selection (Up/Down or Left/Right, PageUp/PageDown, Home/End), the following +keys are recognized: .TP .B Tab (Control\-i) Copy the selected item to the input field. @@ -84,24 +83,19 @@ Confirm selection and quit (print the selected item to standard output). Returns on termination. .TP .B Shift\-Return (Control\-Shift\-j) -Confirm selection and quit (print the text in the input field to standard output). +Confirm input and quit (print the text in the input field to standard output). Returns .B 0 on termination. .TP -.B Escape (Control\-bracketleft) +.B Escape (Control\-c) Quit without selecting an item. Returns .B 1 on termination. .TP -.B Backspace (Control\-h) -Remove a character from the input field. -.TP -.B Control\-u -Remove all characters from the input field. -.TP -.B Control\-w -Remove all characters of current word from the input field. +.B Control\-y +Pastes the X selection into the input field. This requires +.BR sselp (1). .SH SEE ALSO .BR dwm (1), -.BR wmii (1) . +.BR wmii (1). |