dmenu

my build of dmenu
git clone git://git.ckyln.com/~cem/dmenu.git
Log | Files | Refs | README | LICENSE

dmenu.1 (3704B)


      1 .TH DMENU 1 dmenu\-VERSION
      2 .SH NAME
      3 dmenu \- dynamic menu
      4 .SH SYNOPSIS
      5 .B dmenu
      6 .RB [ \-bfivP ]
      7 .RB [ \-l
      8 .IR lines ]
      9 .RB [ \-m
     10 .IR monitor ]
     11 .RB [ \-p
     12 .IR prompt ]
     13 .RB [ \-fn
     14 .IR font ]
     15 .RB [ \-nb
     16 .IR color ]
     17 .RB [ \-nf
     18 .IR color ]
     19 .RB [ \-sb
     20 .IR color ]
     21 .RB [ \-sf
     22 .IR color ]
     23 .RB [ \-nhb
     24 .IR color ]
     25 .RB [ \-nhf
     26 .IR color ]
     27 .RB [ \-shb
     28 .IR color ]
     29 .RB [ \-shf
     30 .IR color ]
     31 .RB [ \-w
     32 .IR windowid ]
     33 .P
     34 .BR dmenu_run " ..."
     35 .SH DESCRIPTION
     36 .B dmenu
     37 is a dynamic menu for X, which reads a list of newline\-separated items from
     38 stdin.  When the user selects an item and presses Return, their choice is printed
     39 to stdout and dmenu terminates.  Entering text will narrow the items to those
     40 matching the tokens in the input.
     41 .P
     42 .B dmenu_run
     43 is a script used by
     44 .IR dwm (1)
     45 which lists programs in the user's $PATH and runs the result in their $SHELL.
     46 .SH OPTIONS
     47 .TP
     48 .B \-b
     49 dmenu appears at the bottom of the screen.
     50 .TP
     51 .B \-c
     52 dmenu appears centered on the screen.
     53 .TP
     54 .B \-f
     55 dmenu grabs the keyboard before reading stdin if not reading from a tty. This
     56 is faster, but will lock up X until stdin reaches end\-of\-file.
     57 .TP
     58 .B \-i
     59 dmenu matches menu items case insensitively.
     60 .TP
     61 .B \-P
     62 dmenu will not directly display the keyboard input, but instead replace it with dots. All data from stdin will be ignored.
     63 .TP
     64 .BI \-l " lines"
     65 dmenu lists items vertically, with the given number of lines.
     66 .TP
     67 .BI \-m " monitor"
     68 dmenu is displayed on the monitor number supplied. Monitor numbers are starting
     69 from 0.
     70 .TP
     71 .BI \-p " prompt"
     72 defines the prompt to be displayed to the left of the input field.
     73 .TP
     74 .BI \-fn " font"
     75 defines the font or font set used.
     76 .TP
     77 .BI \-nb " color"
     78 defines the normal background color.
     79 .IR #RGB ,
     80 .IR #RRGGBB ,
     81 and X color names are supported.
     82 .TP
     83 .BI \-nf " color"
     84 defines the normal foreground color.
     85 .TP
     86 .BI \-sb " color"
     87 defines the selected background color.
     88 .TP
     89 .BI \-sf " color"
     90 defines the selected foreground color.
     91 .TP
     92 .BI \-nhb " color"
     93 defines the normal highlight background color.
     94 .TP
     95 .BI \-nhf " color"
     96 defines the normal highlight foreground color.
     97 .TP
     98 .BI \-shb " color"
     99 defines the selected highlight background color.
    100 .TP
    101 .BI \-shf " color"
    102 defines the selected highlight foreground color.
    103 .TP
    104 .B \-v
    105 prints version information to stdout, then exits.
    106 .TP
    107 .BI \-w " windowid"
    108 embed into windowid.
    109 .SH USAGE
    110 dmenu is completely controlled by the keyboard.  Items are selected using the
    111 arrow keys, page up, page down, home, and end.
    112 .TP
    113 .B Tab
    114 Copy the selected item to the input field.
    115 .TP
    116 .B Return
    117 Confirm selection.  Prints the selected item to stdout and exits, returning
    118 success.
    119 .TP
    120 .B Ctrl-Return
    121 Confirm selection.  Prints the selected item to stdout and continues.
    122 .TP
    123 .B Shift\-Return
    124 Confirm input.  Prints the input text to stdout and exits, returning success.
    125 .TP
    126 .B Escape
    127 Exit without selecting an item, returning failure.
    128 .TP
    129 .B Ctrl-Left
    130 Move cursor to the start of the current word
    131 .TP
    132 .B Ctrl-Right
    133 Move cursor to the end of the current word
    134 .TP
    135 .B C\-a
    136 Home
    137 .TP
    138 .B C\-b
    139 Left
    140 .TP
    141 .B C\-c
    142 Escape
    143 .TP
    144 .B C\-d
    145 Delete
    146 .TP
    147 .B C\-e
    148 End
    149 .TP
    150 .B C\-f
    151 Right
    152 .TP
    153 .B C\-g
    154 Escape
    155 .TP
    156 .B C\-h
    157 Backspace
    158 .TP
    159 .B C\-i
    160 Tab
    161 .TP
    162 .B C\-j
    163 Return
    164 .TP
    165 .B C\-J
    166 Shift-Return
    167 .TP
    168 .B C\-k
    169 Delete line right
    170 .TP
    171 .B C\-m
    172 Return
    173 .TP
    174 .B C\-M
    175 Shift-Return
    176 .TP
    177 .B C\-n
    178 Down
    179 .TP
    180 .B C\-p
    181 Up
    182 .TP
    183 .B C\-u
    184 Delete line left
    185 .TP
    186 .B C\-w
    187 Delete word left
    188 .TP
    189 .B C\-y
    190 Paste from primary X selection
    191 .TP
    192 .B C\-Y
    193 Paste from X clipboard
    194 .TP
    195 .B M\-b
    196 Move cursor to the start of the current word
    197 .TP
    198 .B M\-f
    199 Move cursor to the end of the current word
    200 .TP
    201 .B M\-g
    202 Home
    203 .TP
    204 .B M\-G
    205 End
    206 .TP
    207 .B M\-h
    208 Up
    209 .TP
    210 .B M\-j
    211 Page down
    212 .TP
    213 .B M\-k
    214 Page up
    215 .TP
    216 .B M\-l
    217 Down
    218 .SH SEE ALSO
    219 .IR dwm (1),
    220 .IR stest (1)