dmenu.1

   1 .TH DMENU 1 dmenu-VERSION
   2 .SH NAME
   3 dmenu \- dynamic menu
   4 .SH SYNOPSIS
   5 .B dmenu
   6 .RB [ \-v ]
   7 .SH DESCRIPTION
   8 .SS Overview
   9 dmenu is a generic menu for X, originally designed for
  10 .BR dwm (1).
  11 It manages huge amounts (up to 10.000 and more) of user defined menu items
  12 efficiently.
  13 .SS Options
  14 .TP
  15 .B \-v
  16 prints version information to standard output, then exits.
  17 .SH USAGE
  18 dmenu reads a list of newline-separated items from standard input and creates a
  19 menu.  When the user selects an item or enters any text and presses Return, his
  20 choice is printed to standard output and dmenu terminates.
  21 .P
  22 dmenu is completely controlled by the keyboard. The following keys are recognized:
  23 .TP
  24 .B Any printable character
  25 Appends the character to the text in the input field.  This works as a filter:
  26 only items containing this text will be displayed.
  27 .TP
  28 .B Left/Right
  29 Select the previous/next item.
  30 .TP
  31 .B Tab
  32 Copy the selected item to the input field.
  33 .TP
  34 .B Return
  35 Confirm selection and quit (print the selected item to standard output). Returns
  36 .B 0
  37 on termination.
  38 .TP
  39 .B Shift-Return
  40 Confirm selection and quit (print the text in the input field to standard output).
  41 Returns
  42 .B 0
  43 on termination.
  44 .TP
  45 .B Escape
  46 Quit without selecting an item. Returns
  47 .B 1
  48 on termination.
  49 .TP
  50 .B Backspace (Control-h)
  51 Remove enough characters from the input field to change its filtering effect.
  52 .TP
  53 .B Control-u
  54 Remove all characters from the input field.
  55 .SH CUSTOMIZATION
  56 dmenu is customized by creating a custom config.h and (re)compiling the source
  57 code. This keeps it fast, secure and simple.
  58 .SH SEE ALSO
  59 .BR dwm (1)