X-Git-Url: https://git.danieliu.xyz/?a=blobdiff_plain;f=dmenu.1;h=24ee38b6000345d9f9c8e9252e4c54d2d0fe87a2;hb=569a1f925a7cf351e6ec3e38529f46a1d9becf3f;hp=cfe16b46f631063f1d6c0bd648aa420f49effd3b;hpb=5c0d28e4ff9909059ac1247aa71f9b1e906fea3a;p=dmenu.git diff --git a/dmenu.1 b/dmenu.1 index cfe16b4..24ee38b 100644 --- a/dmenu.1 +++ b/dmenu.1 @@ -1,14 +1,17 @@ -.TH DMENU 1 dmenu-VERSION +.TH DMENU 1 dmenu\-VERSION .SH NAME dmenu \- dynamic menu .SH SYNOPSIS .B dmenu -.RB [ \-font ] -.RB [ \-normbg ] -.RB [ \-normfg ] -.RB [ \-selbg ] -.RB [ \-selfg ] -.RB [ \-t ] +.RB [ \-i ] +.RB [ \-b ] +.RB [ \-l " "] +.RB [ \-fn " "] +.RB [ \-nb " "] +.RB [ \-nf " "] +.RB [ \-p " "] +.RB [ \-sb " "] +.RB [ \-sf " "] .RB [ \-v ] .SH DESCRIPTION .SS Overview @@ -18,29 +21,39 @@ It manages huge amounts (up to 10.000 and more) of user defined menu items efficiently. .SS Options .TP -.B \-font +.B \-i +makes dmenu match menu entries case insensitively. +.TP +.B \-b +defines that dmenu appears at the bottom. +.TP +.B \-l +activates vertical list mode. +The given number of lines will be displayed. Window height will get adjusted. +.TP +.B \-fn defines the font. .TP -.B \-normbg +.B \-nb defines the normal background color (#RGB, #RRGGBB, and color names are supported). .TP -.B \-normfg +.B \-nf defines the normal foreground color (#RGB, #RRGGBB, and color names are supported). .TP -.B \-selbg +.B \-p +defines a prompt to be displayed before the input area. +.TP +.B \-sb defines the selected background color (#RGB, #RRGGBB, and color names are supported). .TP -.B \-selfg +.B \-sf defines the selected foreground color (#RGB, #RRGGBB, and color names are supported). .TP -.B \-t -defines the seconds to wait for standard input, before exiting (default is 3). -.TP .B \-v prints version information to standard output, then exits. .SH USAGE 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 +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: @@ -49,32 +62,42 @@ dmenu is completely controlled by the keyboard. The following keys are recognize 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 +.B Left/Right (Up/Down) (Mod1\-h/Mod1\-l) Select the previous/next item. .TP -.B Tab +.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. +.TP +.B Tab (Control\-i) Copy the selected item to the input field. .TP -.B Return +.B Return (Control\-j) Confirm selection and quit (print the selected item to standard output). Returns .B 0 on termination. .TP -.B Shift-Return +.B Shift\-Return (Control\-Shift\-j) Confirm selection and quit (print the text in the input field to standard output). Returns .B 0 on termination. .TP -.B Escape +.B Escape (Control\-bracketleft) Quit without selecting an item. Returns .B 1 on termination. .TP -.B Backspace (Control-h) -Remove enough characters from the input field to change its filtering effect. +.B Backspace (Control\-h) +Remove a character from the input field. .TP -.B Control-u +.B Control\-u Remove all characters from the input field. +.TP +.B Control\-w +Remove all characters of current word from the input field. .SH SEE ALSO -.BR dwm (1) +.BR dwm (1), +.BR wmii (1) .