X-Git-Url: https://git.danieliu.xyz/?a=blobdiff_plain;f=dmenu.1;h=4e44e2749bf87322f23eaee5db45c2d94a7510dc;hb=900d34347bd6d35e965ad54b7b4a3f67128b3a2b;hp=cfe16b46f631063f1d6c0bd648aa420f49effd3b;hpb=5c0d28e4ff9909059ac1247aa71f9b1e906fea3a;p=dmenu.git diff --git a/dmenu.1 b/dmenu.1 index cfe16b4..4e44e27 100644 --- a/dmenu.1 +++ b/dmenu.1 @@ -1,14 +1,15 @@ -.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 [ \-b ] +.RB [ \-fn " "] +.RB [ \-nb " "] +.RB [ \-nf " "] +.RB [ \-p " "] +.RB [ \-sb " "] +.RB [ \-sf " "] .RB [ \-v ] .SH DESCRIPTION .SS Overview @@ -18,29 +19,32 @@ It manages huge amounts (up to 10.000 and more) of user defined menu items efficiently. .SS Options .TP -.B \-font +.B \-b +makes dmenu appear at the screen bottom (by default it appears at the screen top). +.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 +53,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 (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) +.B Backspace (Control\-h) Remove enough characters from the input field to change its filtering effect. .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) .