X-Git-Url: https://git.danieliu.xyz/?a=blobdiff_plain;f=dmenu.1;h=cfe16b46f631063f1d6c0bd648aa420f49effd3b;hb=5c0d28e4ff9909059ac1247aa71f9b1e906fea3a;hp=7a455038dbd2421ca79c5253c8d6782ac26d7b61;hpb=4e009770d657ffdcd89f2d202e383ca432449391;p=dmenu.git diff --git a/dmenu.1 b/dmenu.1 index 7a45503..cfe16b4 100644 --- a/dmenu.1 +++ b/dmenu.1 @@ -3,62 +3,78 @@ dmenu \- dynamic menu .SH SYNOPSIS .B dmenu +.RB [ \-font ] +.RB [ \-normbg ] +.RB [ \-normfg ] +.RB [ \-selbg ] +.RB [ \-selfg ] +.RB [ \-t ] .RB [ \-v ] .SH DESCRIPTION .SS Overview -.B dmenu -is a generic, highly customizable, and efficient menu for the X Window System, -originally designed for +dmenu is a generic menu for X, originally designed for .BR dwm (1). -It supports arbitrary, user defined menu contents. +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 \-t +defines the seconds to wait for standard input, before exiting (default is 3). +.TP .B \-v -prints version information to stdout, then exits. +prints version information to standard output, then exits. .SH USAGE -.B dmenu -reads a list of newline-separated items from stdin and creates a menu. -When the user selects an item or enters any text and presses Return, his choice -is printed to stdout and -.B dmenu -terminates. -.B dmenu -is completely controlled by the keyboard. The following keys are recognized: +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 +choice is printed to standard output and dmenu terminates. +.P +dmenu is completely controlled by the keyboard. The following keys are recognized: .TP -Any printable character -Appends the character to the text in the input field. This works as a filter: +.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 -Left/Right (Control-p/Control-n) +.B Left/Right Select the previous/next item. .TP -Tab (Control-i) +.B Tab Copy the selected item to the input field. .TP -Return (Control-j) -Confirm selection and quit (print the selected item to stdout). +.B Return +Confirm selection and quit (print the selected item to standard output). Returns +.B 0 +on termination. .TP -Shift-Return (Shift-Control-j) -Confirm selection and quit (print the text in the input field to stdout). +.B Shift-Return +Confirm selection and quit (print the text in the input field to standard output). +Returns +.B 0 +on termination. .TP -Escape (Control-[) -Quit without selecting an item. +.B Escape +Quit without selecting an item. Returns +.B 1 +on termination. .TP -Backspace (Control-h) +.B Backspace (Control-h) Remove enough characters from the input field to change its filtering effect. .TP -Control-u +.B Control-u Remove all characters from the input field. -.P -.B dmenu -returns -.B 0 -if Return is pressed on termination, -.B 1 -if Escape is pressed. -.SH CUSTOMIZATION -.B 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)