|
@ -4,6 +4,7 @@ dmenu \- dynamic menu |
|
|
.SH SYNOPSIS |
|
|
.SH SYNOPSIS |
|
|
.B dmenu |
|
|
.B dmenu |
|
|
.RB [ \-b ] |
|
|
.RB [ \-b ] |
|
|
|
|
|
.RB [ \-f ] |
|
|
.RB [ \-i ] |
|
|
.RB [ \-i ] |
|
|
.RB [ \-l |
|
|
.RB [ \-l |
|
|
.IR lines ] |
|
|
.IR lines ] |
|
@ -32,9 +33,9 @@ is a dynamic menu for X, originally designed for |
|
|
.BR dwm (1). |
|
|
.BR dwm (1). |
|
|
It manages huge numbers of user-defined menu items efficiently. |
|
|
It manages huge numbers of user-defined menu items efficiently. |
|
|
.P |
|
|
.P |
|
|
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, |
|
|
|
|
|
their choice is printed to standard output and dmenu terminates. |
|
|
|
|
|
|
|
|
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, their |
|
|
|
|
|
choice is printed to stdout and dmenu terminates. |
|
|
.P |
|
|
.P |
|
|
.B dmenu_run |
|
|
.B dmenu_run |
|
|
is a dmenu script used by dwm which lists programs in the user's PATH and |
|
|
is a dmenu script used by dwm which lists programs in the user's PATH and |
|
@ -47,6 +48,10 @@ is a program used by dmenu_run to find and cache a list of executables. |
|
|
.B \-b |
|
|
.B \-b |
|
|
dmenu appears at the bottom of the screen. |
|
|
dmenu appears at the bottom of the screen. |
|
|
.TP |
|
|
.TP |
|
|
|
|
|
.B \-f |
|
|
|
|
|
dmenu grabs the keyboard before reading stdin. This is faster, but may lock up |
|
|
|
|
|
X if stdin is from a terminal. |
|
|
|
|
|
.TP |
|
|
.B \-i |
|
|
.B \-i |
|
|
dmenu matches menu items case insensitively. |
|
|
dmenu matches menu items case insensitively. |
|
|
.TP |
|
|
.TP |
|
@ -66,7 +71,7 @@ defines the font or font set used. |
|
|
defines the normal background color. |
|
|
defines the normal background color. |
|
|
.IR #RGB , |
|
|
.IR #RGB , |
|
|
.IR #RRGGBB , |
|
|
.IR #RRGGBB , |
|
|
and color names are supported. |
|
|
|
|
|
|
|
|
and X color names are supported. |
|
|
.TP |
|
|
.TP |
|
|
.BI \-nf " color" |
|
|
.BI \-nf " color" |
|
|
defines the normal foreground color. |
|
|
defines the normal foreground color. |
|
@ -78,7 +83,7 @@ defines the selected background color. |
|
|
defines the selected foreground color. |
|
|
defines the selected foreground color. |
|
|
.TP |
|
|
.TP |
|
|
.B \-v |
|
|
.B \-v |
|
|
prints version information to standard output, then exits. |
|
|
|
|
|
|
|
|
prints version information to stdout, then exits. |
|
|
.SH USAGE |
|
|
.SH USAGE |
|
|
dmenu is completely controlled by the keyboard. Besides standard Unix line |
|
|
dmenu is completely controlled by the keyboard. Besides standard Unix line |
|
|
editing and item selection (Up/Down/Left/Right, PageUp/PageDown, Home/End), the |
|
|
editing and item selection (Up/Down/Left/Right, PageUp/PageDown, Home/End), the |
|
@ -88,12 +93,11 @@ following keys are recognized: |
|
|
Copy the selected item to the input field. |
|
|
Copy the selected item to the input field. |
|
|
.TP |
|
|
.TP |
|
|
.B Return (Control\-j) |
|
|
.B Return (Control\-j) |
|
|
Confirm selection. Prints the selected item to standard output and exits, |
|
|
|
|
|
returning success. |
|
|
|
|
|
|
|
|
Confirm selection. Prints the selected item to stdout and exits, returning |
|
|
|
|
|
success. |
|
|
.TP |
|
|
.TP |
|
|
.B Shift\-Return (Control\-Shift\-j) |
|
|
.B Shift\-Return (Control\-Shift\-j) |
|
|
Confirm input. Prints the input text to standard output and exits, returning |
|
|
|
|
|
success. |
|
|
|
|
|
|
|
|
Confirm input. Prints the input text to stdout and exits, returning success. |
|
|
.TP |
|
|
.TP |
|
|
.B Escape (Control\-c) |
|
|
.B Escape (Control\-c) |
|
|
Exit without selecting an item, returning failure. |
|
|
Exit without selecting an item, returning failure. |
|
|