X-Git-Url: https://git.danieliu.xyz/?a=blobdiff_plain;f=dmenu.1;h=8295d17a28be76753a3f2e0f43daf493e1600432;hb=bb3e33def3e5156594ac59b75dc52798accbebcd;hp=d2a93d1ea4860e9f329fd4051f0f76c2c522b866;hpb=8d9ade36de4666835e49fe4366ff04cfe540dce6;p=dmenu.git diff --git a/dmenu.1 b/dmenu.1 index d2a93d1..8295d17 100644 --- a/dmenu.1 +++ b/dmenu.1 @@ -4,11 +4,10 @@ dmenu \- dynamic menu .SH SYNOPSIS .B dmenu .RB [ \-b ] +.RB [ \-f ] .RB [ \-i ] .RB [ \-l .IR lines ] -.RB [ \-m -.IR monitor ] .RB [ \-p .IR prompt ] .RB [ \-fn @@ -30,32 +29,33 @@ dmenu \- dynamic menu .B dmenu is a dynamic menu for X, originally designed for .BR dwm (1). -It manages huge numbers of user-defined menu items efficiently. +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. +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 .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 program used by dmenu_run to find and cache a list of executables. +is a script used by dmenu_run to find and cache a list of executables. .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 may lock up +X if stdin is from a terminal. +.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 appears on the given Xinerama screen. -.TP .BI \-p " prompt" defines the prompt to be displayed to the left of the input field. .TP @@ -66,7 +66,7 @@ defines the font or font set used. 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. @@ -78,27 +78,26 @@ 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 +editing and item selection (arrow keys, page up/down, home and end), the following keys are recognized: .TP -.B Tab (Control\-i) +.B Tab (Ctrl\-i) 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 (Ctrl\-j) +Confirm selection. Prints the selected item to stdout and exits, returning success. .TP -.B Escape (Control\-c) +.B Shift\-Return (Ctrl\-Shift\-j) +Confirm input. Prints the input text to stdout and exits, returning success. +.TP +.B Escape (Ctrl\-c) Exit without selecting an item, returning failure. .TP -.B Control\-y +.B Ctrl\-y Paste the current X selection into the input field. .SH SEE ALSO .BR dwm (1)