X-Git-Url: https://git.danieliu.xyz/?a=blobdiff_plain;f=dmenu.1;h=38e485dc0d87a486dfd5e045d40d6a39c3d72c35;hb=65912f2a96d32600a07b963e9149f70ca22e73bb;hp=fa3adc0b3a1d063e9d7ebb181c2f6ecc09d35928;hpb=1f207893e6162f8ae8be17440830ca1eb1e80746;p=dmenu.git diff --git a/dmenu.1 b/dmenu.1 index fa3adc0..38e485d 100644 --- a/dmenu.1 +++ b/dmenu.1 @@ -3,6 +3,13 @@ dmenu \- dynamic menu .SH SYNOPSIS .B dmenu +.RB [ \-font " "] +.RB [ \-normbg " "] +.RB [ \-normfg " "] +.RB [ \-selbg " "] +.RB [ \-selfg " "] +.RB [ \-p " "] +.RB [ \-t " "] .RB [ \-v ] .SH DESCRIPTION .SS Overview @@ -12,11 +19,32 @@ It manages huge amounts (up to 10.000 and more) of user defined menu items efficiently. .SS Options .TP +.B \-font +defines the font. +.TP +.B \-normbg +defines the normal background color (#RGB, #RRGGBB, and color names are supported). +.TP +.B \-normfg +defines the normal foreground color (#RGB, #RRGGBB, and color names are supported). +.TP +.B \-selbg +defines the selected background color (#RGB, #RRGGBB, and color names are supported). +.TP +.B \-selfg +defines the selected foreground color (#RGB, #RRGGBB, and color names are supported). +.TP +.B \-p +defines a prompt being displayed before input area. +.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: @@ -28,35 +56,35 @@ only items containing this text will be displayed. .B Left/Right Select the previous/next item. .TP +.B PageUp/PageDown +Select the first item of the previous/next 'page' of items. +.TP +.B Home/End +Select the first/last item. +.TP .B Tab Copy the selected item to the input field. .TP .B Return -Confirm selection and quit (print the selected item to standard output). +Confirm selection and quit (print the selected item to standard output). Returns +.B 0 +on termination. .TP .B Shift-Return Confirm selection and quit (print the text in the input field to standard output). +Returns +.B 0 +on termination. .TP .B Escape -Quit without selecting an item. +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. .TP .B Control-u Remove all characters from the input field. -.P -dwm returns -.B 0 -if -.B Return -is pressed and -.B 1 -if -.B Escape -is pressed on termination. -.SH CUSTOMIZATION -dmenu is customized by creating a custom config.h and (re)compiling the source -code. This keeps it fast, secure and simple. .SH SEE ALSO .BR dwm (1)