123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195 |
- .TH DMENU 1 dmenu\-VERSION
- .SH NAME
- dmenu \- dynamic menu
- .SH SYNOPSIS
- .B dmenu
- .RB [ \-bfiv ]
- .RB [ \-l
- .IR lines ]
- .RB [ \-m
- .IR monitor ]
- .RB [ \-p
- .IR prompt ]
- .RB [ \-fn
- .IR font ]
- .RB [ \-nb
- .IR color ]
- .RB [ \-nf
- .IR color ]
- .RB [ \-sb
- .IR color ]
- .RB [ \-sf
- .IR color ]
- .RB [ \-w
- .IR windowid ]
- .P
- .BR dmenu_run " ..."
- .SH DESCRIPTION
- .B dmenu
- is a dynamic menu for X, which reads a list of newline\-separated items from
- stdin. When the user selects an item and presses Return, their choice is printed
- to stdout and dmenu terminates. Entering text will narrow the items to those
- matching the tokens in the input.
- .P
- .B dmenu_run
- is a script used by
- .IR dwm (1)
- which lists programs in the user's $PATH and runs the result in their $SHELL.
- .SH OPTIONS
- .TP
- .B \-b
- dmenu appears at the bottom of the screen.
- .TP
- .B \-f
- dmenu grabs the keyboard before reading stdin if not reading from a tty. This
- is faster, but will lock up X until stdin reaches end\-of\-file.
- .TP
- .B \-i
- dmenu matches menu items case insensitively.
- .TP
- .BI \-l " lines"
- dmenu lists items vertically, with the given number of lines.
- .TP
- .BI \-m " monitor"
- dmenu is displayed on the monitor number supplied. Monitor numbers are starting
- from 0.
- .TP
- .BI \-p " prompt"
- defines the prompt to be displayed to the left of the input field.
- .TP
- .BI \-fn " font"
- defines the font or font set used.
- .TP
- .BI \-nb " color"
- defines the normal background color.
- .IR #RGB ,
- .IR #RRGGBB ,
- and X color names are supported.
- .TP
- .BI \-nf " color"
- defines the normal foreground color.
- .TP
- .BI \-sb " color"
- defines the selected background color.
- .TP
- .BI \-sf " color"
- defines the selected foreground color.
- .TP
- .B \-v
- prints version information to stdout, then exits.
- .TP
- .BI \-w " windowid"
- embed into windowid.
- .SH USAGE
- dmenu is completely controlled by the keyboard. Items are selected using the
- arrow keys, page up, page down, home, and end.
- .TP
- .B Tab
- Copy the selected item to the input field.
- .TP
- .B Return
- Confirm selection. Prints the selected item to stdout and exits, returning
- success.
- .TP
- .B Ctrl-Return
- Confirm selection. Prints the selected item to stdout and continues.
- .TP
- .B Shift\-Return
- Confirm input. Prints the input text to stdout and exits, returning success.
- .TP
- .B Escape
- Exit without selecting an item, returning failure.
- .TP
- .B Ctrl-Left
- Move cursor to the start of the current word
- .TP
- .B Ctrl-Right
- Move cursor to the end of the current word
- .TP
- .B C\-a
- Home
- .TP
- .B C\-b
- Left
- .TP
- .B C\-c
- Escape
- .TP
- .B C\-d
- Delete
- .TP
- .B C\-e
- End
- .TP
- .B C\-f
- Right
- .TP
- .B C\-g
- Escape
- .TP
- .B C\-h
- Backspace
- .TP
- .B C\-i
- Tab
- .TP
- .B C\-j
- Return
- .TP
- .B C\-J
- Shift-Return
- .TP
- .B C\-k
- Delete line right
- .TP
- .B C\-m
- Return
- .TP
- .B C\-M
- Shift-Return
- .TP
- .B C\-n
- Down
- .TP
- .B C\-p
- Up
- .TP
- .B C\-u
- Delete line left
- .TP
- .B C\-w
- Delete word left
- .TP
- .B C\-y
- Paste from primary X selection
- .TP
- .B C\-Y
- Paste from X clipboard
- .TP
- .B M\-b
- Move cursor to the start of the current word
- .TP
- .B M\-f
- Move cursor to the end of the current word
- .TP
- .B M\-g
- Home
- .TP
- .B M\-G
- End
- .TP
- .B M\-h
- Up
- .TP
- .B M\-j
- Page down
- .TP
- .B M\-k
- Page up
- .TP
- .B M\-l
- Down
- .SH SEE ALSO
- .IR dwm (1),
- .IR stest (1)
|