summaryrefslogtreecommitdiff
path: root/dmenu.1
diff options
context:
space:
mode:
Diffstat (limited to 'dmenu.1')
-rw-r--r--dmenu.168
1 files changed, 68 insertions, 0 deletions
diff --git a/dmenu.1 b/dmenu.1
new file mode 100644
index 0000000..da69047
--- /dev/null
+++ b/dmenu.1
@@ -0,0 +1,68 @@
+.TH DMENU 1 d-0.0
+.SH NAME
+dmenu \- dynamic menu
+.SH SYNOPSIS
+.B dmenu
+.RB [ \-v ]
+.RB [ \-t
+.IR title ]
+.SH DESCRIPTION
+.SS Overview
+.B dmenu
+is a generic, highly customizable, and efficient menu for the X Window System,
+originally designed for
+.BR dwm (1).
+It supports arbitrary, user defined menu contents.
+.SS Options
+.TP
+.B \-v
+prints version information to stdout, then exits.
+.TP
+.BI \-t " title"
+displays
+.I title
+above the menu.
+.SS 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 Enter, his choice
+is printed to stdout and
+.B dmenu
+terminates.
+.SS Keyboard Control
+.B dmenu
+is completely controlled by the keyboard. The following keys are recognized:
+.TP 2
+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 2
+Left/Right (Control-p/Control-n)
+select the previous/next item.
+.TP 2
+Tab (Control-i)
+copy the selected item to the input field.
+.TP 2
+Enter (Control-j)
+confirm selection and quit (print the selected item to stdout).
+.TP 2
+Shift-Enter (Shift-Control-j)
+confirm selection and quit (print the text in the input field to stdout).
+.TP 2
+Escape (Control-[)
+quit without selecting an item.
+.TP 2
+Backspace (Control-h)
+remove enough characters from the input field to change its filtering effect.
+.TP 2
+Control-u
+remove all characters from the input field.
+.SS Exit codes
+.B dmenu
+returns
+.B 0
+if Enter is pressed on termination,
+.B 1
+if Escape is pressed.
+.SH SEE ALSO
+.BR dwm (1)