X-Git-Url: https://git.danieliu.xyz/?a=blobdiff_plain;f=dmenu.1;h=2afa17cccc6a8ec778473c79c1c3bcdbae6b81bd;hb=665488a6eedeecf743e44bd9624105c8b47c4f97;hp=7495ef3415ce8552dd81709d9064ba27cc485eb2;hpb=358f078c0b8e235bd14cded2330b78a2e1c08685;p=dmenu.git diff --git a/dmenu.1 b/dmenu.1 index 7495ef3..2afa17c 100644 --- a/dmenu.1 +++ b/dmenu.1 @@ -3,6 +3,14 @@ dmenu \- dynamic menu .SH SYNOPSIS .B dmenu +.RB [ \-b ] +.RB [ \-fn " "] +.RB [ \-nb " "] +.RB [ \-nf " "] +.RB [ \-p " "] +.RB [ \-sb " "] +.RB [ \-sf " "] +.RB [ \-t " "] .RB [ \-v ] .SH DESCRIPTION .SS Overview @@ -12,11 +20,35 @@ It manages huge amounts (up to 10.000 and more) of user defined menu items efficiently. .SS Options .TP +.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 \-nb +defines the normal background color (#RGB, #RRGGBB, and color names are supported). +.TP +.B \-nf +defines the normal foreground color (#RGB, #RRGGBB, and color names are supported). +.TP +.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 \-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: @@ -25,24 +57,30 @@ 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. @@ -52,8 +90,9 @@ Remove enough characters from the input field to change its filtering effect. .TP .B Control-u Remove all characters from the input field. -.SH CUSTOMIZATION -dmenu is customized by creating a custom config.h and (re)compiling the source -code. This keeps it fast, secure and simple. +.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) .