X-Git-Url: https://git.armaanb.net/?p=dmenu.git;a=blobdiff_plain;f=dmenu.1;h=2897ab138ce9671fd9299a17b49bc0aae5673102;hp=a1ec695c2a06584b29a7ca38cfbadc41ba503a99;hb=5a20b409c673a6736c3f9326cb54edc32908f717;hpb=31ffcd3b9a2beccb8b8830055748e52e07b3b258 diff --git a/dmenu.1 b/dmenu.1 index a1ec695..2897ab1 100644 --- a/dmenu.1 +++ b/dmenu.1 @@ -4,8 +4,11 @@ dmenu \- dynamic menu .SH SYNOPSIS .B dmenu .RB [ \-b ] +.RB [ \-f ] .RB [ \-i ] .RB [ \-l +.RB [ \-m +.IR monitor ] .IR lines ] .RB [ \-p .IR prompt ] @@ -22,46 +25,46 @@ dmenu \- dynamic menu .RB [ \-v ] .P .BR dmenu_run " ..." -.P -.B dmenu_path .SH DESCRIPTION .B dmenu -is a dynamic menu for X, originally designed for -.BR dwm (1). -It manages huge numbers of user-defined menu items efficiently. -.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. +is a dynamic menu for X, which reads a list of newline\-separated items from +stdin. When the user selects an item and presses Return, their choice is printed +to stdout and dmenu terminates. Entering text will narrow the items to those +matching the tokens in the input. .P .B dmenu_run -is a dmenu script used by dwm which lists programs in the user's PATH and -executes the selected item. -.P -.B dmenu_path -is a script used by dmenu_run to find and cache a list of programs. +is a script used by +.IR dwm (1) +which lists programs in the user's $PATH and runs the result in their $SHELL. .SH OPTIONS .TP .B \-b dmenu appears at the bottom of the screen. .TP +.B \-f +dmenu grabs the keyboard before reading stdin. This is faster, but will lock up +X until stdin reaches end\-of\-file. +.TP .B \-i dmenu matches menu items case insensitively. .TP .BI \-l " lines" dmenu lists items vertically, with the given number of lines. .TP +.BI \-m " monitor" +dmenu is displayed on the monitor supplied. +.TP .BI \-p " prompt" defines the prompt to be displayed to the left of the input field. .TP .BI \-fn " font" -defines the font set used. +defines the font or font set used. .TP .BI \-nb " color" defines the normal background color. .IR #RGB , .IR #RRGGBB , -and color names are supported. +and X color names are supported. .TP .BI \-nf " color" defines the normal foreground color. @@ -73,27 +76,104 @@ defines the selected background color. defines the selected foreground color. .TP .B \-v -prints version information to standard output, then exits. +prints version information to stdout, then exits. .SH USAGE -dmenu is completely controlled by the keyboard. Besides standard Unix line -editing and item selection (Up/Down/Left/Right, PageUp/PageDown, Home/End), the -following keys are recognized: +dmenu is completely controlled by the keyboard. Items are selected using the +arrow keys, page up, page down, home, and end. .TP -.B Tab (Control\-i) +.B Tab Copy the selected item to the input field. .TP -.B Return (Control\-j) -Confirm selection. Prints the selected item to standard output and exits, -returning success. -.TP -.B Shift\-Return (Control\-Shift\-j) -Confirm input. Prints the input text to standard output and exits, returning +.B Return +Confirm selection. Prints the selected item to stdout and exits, returning success. .TP -.B Escape (Control\-c) +.B Ctrl-Return +Confirm selection. Prints the selected item to stdout and continues. +.TP +.B Shift\-Return +Confirm input. Prints the input text to stdout and exits, returning success. +.TP +.B Escape Exit without selecting an item, returning failure. .TP -.B Control\-y -Paste the current X selection into the input field. +C\-a +Home +.TP +C\-b +Left +.TP +C\-c +Escape +.TP +C\-d +Delete +.TP +C\-e +End +.TP +C\-f +Right +.TP +C\-g +Escape +.TP +C\-h +Backspace +.TP +C\-i +Tab +.TP +C\-j +Return +.TP +C\-J +Shift-Return +.TP +C\-k +Delete line right +.TP +C\-m +Return +.TP +C\-M +Shift-Return +.TP +C\-n +Down +.TP +C\-p +Up +.TP +C\-u +Delete line left +.TP +C\-w +Delete word left +.TP +C\-y +Paste from primary X selection +.TP +C\-Y +Paste from X clipboard +.TP +M\-g +Home +.TP +M\-G +End +.TP +M\-h +Up +.TP +M\-j +Page down +.TP +M\-k +Page up +.TP +M\-l +Down .SH SEE ALSO -.BR dwm (1) +.IR dwm (1), +.IR stest (1)