dmenu/dmenu.1

81 lines
2.1 KiB
Groff
Raw Normal View History

.TH DMENU 1 dmenu-VERSION
2006-08-04 08:35:27 +01:00
.SH NAME
dmenu \- dynamic menu
.SH SYNOPSIS
.B dmenu
.RB [ \-font <name> ]
.RB [ \-normbg <color> ]
.RB [ \-normfg <color> ]
.RB [ \-selbg <color> ]
.RB [ \-selfg <color> ]
.RB [ \-t <seconds> ]
2006-08-04 08:35:27 +01:00
.RB [ \-v ]
.SH DESCRIPTION
.SS Overview
2006-09-07 08:36:53 +01:00
dmenu is a generic menu for X, originally designed for
2006-08-04 08:35:27 +01:00
.BR dwm (1).
2006-09-04 18:47:09 +01:00
It manages huge amounts (up to 10.000 and more) of user defined menu items
efficiently.
2006-08-04 08:35:27 +01:00
.SS Options
.TP
.B \-font <name>
defines the font.
.TP
.B \-normbg <color>
defines the normal background color (#RGB, #RRGGBB, and color names are supported).
.TP
.B \-normfg <color>
defines the normal foreground color (#RGB, #RRGGBB, and color names are supported).
.TP
.B \-selbg <color>
defines the selected background color (#RGB, #RRGGBB, and color names are supported).
.TP
.B \-selfg <color>
defines the selected foreground color (#RGB, #RRGGBB, and color names are supported).
.TP
.B \-t <seconds>
defines the seconds to wait for standard input, before exiting (default is 3).
.TP
2006-08-04 08:35:27 +01:00
.B \-v
2006-08-28 06:22:38 +01:00
prints version information to standard output, then exits.
2006-08-07 13:07:04 +01:00
.SH USAGE
2006-09-07 08:36:53 +01:00
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:
2006-08-07 13:07:04 +01:00
.TP
2006-09-07 08:36:53 +01:00
.B Any printable character
Appends the character to the text in the input field. This works as a filter:
2006-08-04 08:35:27 +01:00
only items containing this text will be displayed.
2006-08-07 13:07:04 +01:00
.TP
2006-09-07 08:36:53 +01:00
.B Left/Right
2006-08-07 13:07:04 +01:00
Select the previous/next item.
.TP
2006-09-07 08:36:53 +01:00
.B Tab
2006-08-07 13:07:04 +01:00
Copy the selected item to the input field.
.TP
2006-09-07 08:36:53 +01:00
.B Return
2006-09-07 08:40:09 +01:00
Confirm selection and quit (print the selected item to standard output). Returns
.B 0
on termination.
2006-08-07 13:07:04 +01:00
.TP
2006-09-07 08:36:53 +01:00
.B Shift-Return
2006-08-28 06:22:38 +01:00
Confirm selection and quit (print the text in the input field to standard output).
2006-09-07 08:40:09 +01:00
Returns
.B 0
on termination.
2006-08-07 13:07:04 +01:00
.TP
2006-09-07 08:36:53 +01:00
.B Escape
2006-09-07 08:40:09 +01:00
Quit without selecting an item. Returns
.B 1
on termination.
2006-08-07 13:07:04 +01:00
.TP
2006-09-07 08:36:53 +01:00
.B Backspace (Control-h)
2006-08-07 13:07:04 +01:00
Remove enough characters from the input field to change its filtering effect.
.TP
2006-09-07 08:36:53 +01:00
.B Control-u
2006-08-07 13:07:04 +01:00
Remove all characters from the input field.
2006-08-04 08:35:27 +01:00
.SH SEE ALSO
.BR dwm (1)