X-Git-Url: https://git.danieliu.xyz/?a=blobdiff_plain;f=dmenu.1;h=fa3adc0b3a1d063e9d7ebb181c2f6ecc09d35928;hb=1f207893e6162f8ae8be17440830ca1eb1e80746;hp=f49dda9e3390b585501da3e0b82d7e8f58514e61;hpb=6a332a043a0674884dcb3b449628be3fb3a07017;p=dmenu.git diff --git a/dmenu.1 b/dmenu.1 index f49dda9..fa3adc0 100644 --- a/dmenu.1 +++ b/dmenu.1 @@ -1,4 +1,4 @@ -.TH DMENU 1 d-0.3 +.TH DMENU 1 dmenu-VERSION .SH NAME dmenu \- dynamic menu .SH SYNOPSIS @@ -6,60 +6,57 @@ dmenu \- dynamic menu .RB [ \-v ] .SH DESCRIPTION .SS Overview -.B dmenu -is a generic, highly customizable, and efficient menu for the X Window System, -originally designed for +dmenu is a generic menu for X, originally designed for .BR dwm (1). -It supports arbitrary, user defined menu contents. +It manages huge amounts (up to 10.000 and more) of user defined menu items +efficiently. .SS Options .TP .B \-v -prints version information to stdout, then exits. -.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: +prints version information to standard output, then exits. +.SH USAGE +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 +.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. -.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 +.TP +.B Left/Right +Select the previous/next item. +.TP +.B Tab +Copy the selected item to the input field. +.TP +.B Return +Confirm selection and quit (print the selected item to standard output). +.TP +.B Shift-Return +Confirm selection and quit (print the text in the input field to standard output). +.TP +.B Escape +Quit without selecting an item. +.TP +.B Backspace (Control-h) +Remove enough characters from the input field to change its filtering effect. +.TP +.B Control-u +Remove all characters from the input field. +.P +dwm returns .B 0 -if Enter is pressed on termination, +if +.B Return +is pressed and .B 1 -if Escape is pressed. +if +.B Escape +is pressed on termination. .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. .SH SEE ALSO .BR dwm (1)