|
@ -6,8 +6,7 @@ dmenu \- dynamic menu |
|
|
.RB [ \-v ] |
|
|
.RB [ \-v ] |
|
|
.SH DESCRIPTION |
|
|
.SH DESCRIPTION |
|
|
.SS Overview |
|
|
.SS Overview |
|
|
.B dmenu |
|
|
|
|
|
is a generic menu for X, originally designed for |
|
|
|
|
|
|
|
|
dmenu is a generic menu for X, originally designed for |
|
|
.BR dwm (1). |
|
|
.BR dwm (1). |
|
|
It manages huge amounts (up to 10.000 and more) of user defined menu items |
|
|
It manages huge amounts (up to 10.000 and more) of user defined menu items |
|
|
efficiently. |
|
|
efficiently. |
|
@ -16,49 +15,48 @@ efficiently. |
|
|
.B \-v |
|
|
.B \-v |
|
|
prints version information to standard output, then exits. |
|
|
prints version information to standard output, then exits. |
|
|
.SH USAGE |
|
|
.SH USAGE |
|
|
.B 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 |
|
|
|
|
|
.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 |
|
|
.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. |
|
|
only items containing this text will be displayed. |
|
|
.TP |
|
|
.TP |
|
|
Left/Right |
|
|
|
|
|
|
|
|
.B Left/Right |
|
|
Select the previous/next item. |
|
|
Select the previous/next item. |
|
|
.TP |
|
|
.TP |
|
|
Tab |
|
|
|
|
|
|
|
|
.B Tab |
|
|
Copy the selected item to the input field. |
|
|
Copy the selected item to the input field. |
|
|
.TP |
|
|
.TP |
|
|
Return |
|
|
|
|
|
|
|
|
.B Return |
|
|
Confirm selection and quit (print the selected item to standard output). |
|
|
Confirm selection and quit (print the selected item to standard output). |
|
|
.TP |
|
|
.TP |
|
|
Shift-Return |
|
|
|
|
|
|
|
|
.B Shift-Return |
|
|
Confirm selection and quit (print the text in the input field to standard output). |
|
|
Confirm selection and quit (print the text in the input field to standard output). |
|
|
.TP |
|
|
.TP |
|
|
Escape |
|
|
|
|
|
|
|
|
.B Escape |
|
|
Quit without selecting an item. |
|
|
Quit without selecting an item. |
|
|
.TP |
|
|
.TP |
|
|
Backspace (Control-h) |
|
|
|
|
|
|
|
|
.B Backspace (Control-h) |
|
|
Remove enough characters from the input field to change its filtering effect. |
|
|
Remove enough characters from the input field to change its filtering effect. |
|
|
.TP |
|
|
.TP |
|
|
Control-u |
|
|
|
|
|
|
|
|
.B Control-u |
|
|
Remove all characters from the input field. |
|
|
Remove all characters from the input field. |
|
|
.P |
|
|
.P |
|
|
.B dmenu |
|
|
|
|
|
returns |
|
|
|
|
|
|
|
|
dwm returns |
|
|
.B 0 |
|
|
.B 0 |
|
|
if Return is pressed on termination, |
|
|
|
|
|
|
|
|
if |
|
|
|
|
|
.B Return |
|
|
|
|
|
is pressed and |
|
|
.B 1 |
|
|
.B 1 |
|
|
if Escape is pressed. |
|
|
|
|
|
|
|
|
if |
|
|
|
|
|
.B Escape |
|
|
|
|
|
is pressed on termination. |
|
|
.SH CUSTOMIZATION |
|
|
.SH CUSTOMIZATION |
|
|
.B dmenu |
|
|
|
|
|
is customized by creating a custom config.h and (re)compiling the source |
|
|
|
|
|
|
|
|
dmenu is customized by creating a custom config.h and (re)compiling the source |
|
|
code. This keeps it fast, secure and simple. |
|
|
code. This keeps it fast, secure and simple. |
|
|
.SH SEE ALSO |
|
|
.SH SEE ALSO |
|
|
.BR dwm (1) |
|
|
.BR dwm (1) |