added dmenu.h, common.c

[dmenu.git] / dmenu.1

diff --git a/dmenu.1 b/dmenu.1
index 4bc5b03..f0c45f4 100644 (file)
--- a/dmenu.1
+++ b/dmenu.1
@@ -1,27 +1,49 @@
-.TH DMENU 1 dmenu-VERSION
+.TH DMENU 1 dmenu\-VERSION

 .SH NAME
 dmenu \- dynamic menu
 .SH SYNOPSIS
 .B dmenu
 .SH NAME
 dmenu \- dynamic menu
 .SH SYNOPSIS
 .B dmenu

+.RB [ \-i ]

 .RB [ \-b ]
 .RB [ \-b ]

-.RB [ \-fn " <font>"]
-.RB [ \-nb " <color>"]
-.RB [ \-nf " <color>"]
-.RB [ \-p " <prompt>"]
-.RB [ \-sb " <color>"]
-.RB [ \-sf " <color>"]
-.RB [ \-t " <seconds>"]
+.RB [ \-e " <xid>]"
+.RB [ \-l " <lines>]"
+.RB [ \-fn " <font>]"
+.RB [ \-nb " <color>]"
+.RB [ \-nf " <color>]"
+.RB [ \-p " <prompt>]"
+.RB [ \-sb " <color>]"
+.RB [ \-sf " <color>]"

 .RB [ \-v ]
 .RB [ \-v ]

+
+.B dmenu_run
+[<options...>]
+
+.B dmenu_path

 .SH DESCRIPTION
 .SS Overview
 dmenu is a generic menu for X, originally designed for
 .BR dwm (1).
 It manages huge amounts (up to 10.000 and more) of user defined menu items
 efficiently.
 .SH DESCRIPTION
 .SS Overview
 dmenu is a generic menu for X, originally designed for
 .BR dwm (1).
 It manages huge amounts (up to 10.000 and more) of user defined menu items
 efficiently.

+
+dmenu_run is a dmenu script used by dwm which lists executables in the user's PATH
+and executes the selected item.
+
+dmenu_path is a script used by dmenu_run to find and cache a list of executables.

 .SS Options
 .TP
 .SS Options
 .TP

+.B \-i
+makes dmenu match menu entries case insensitively.
+.TP

 .B \-b
 .B \-b

-makes dmenu appear at the screen bottom (by default it appears at the screen top).
+defines that dmenu appears at the bottom.
+.TP
+.B \-e <xid>
+reparents dmenu to the window specified by xid.
+.TP
+.B \-l <lines>
+activates vertical list mode.
+The given number of lines will be displayed. Window height will be adjusted.

 .TP
 .B \-fn <font>
 defines the font.
 .TP
 .B \-fn <font>
 defines the font.


@@ -41,9 +63,6 @@ defines the selected background color (#RGB, #RRGGBB, and color names are suppor
 .B \-sf <color>
 defines the selected foreground color (#RGB, #RRGGBB, and color names are supported).
 .TP
 .B \-sf <color>
 defines the selected foreground color (#RGB, #RRGGBB, and color names are supported).
 .TP

-.B \-t <seconds>
-defines the seconds to wait for standard input, before exiting (default is 3).
-.TP

 .B \-v
 prints version information to standard output, then exits.
 .SH USAGE
 .B \-v
 prints version information to standard output, then exits.
 .SH USAGE


@@ -51,45 +70,32 @@ 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/her
 choice is printed to standard output and dmenu terminates.
 .P
 menu.  When the user selects an item or enters any text and presses Return, his/her
 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.
+dmenu is completely controlled by the keyboard. Besides standard Unix line editing,
+and item selection (Up/Down or Left/Right, PageUp/PageDown, Home/End), the following
+keys are recognized:

 .TP
 .TP

-.B Left/Right (Mod1-h/Mod1-l)
-Select the previous/next item.
-.TP
-.B PageUp/PageDown (Mod1-k/Mod1-j)
-Select the first item of the previous/next 'page' of items.
-.TP
-.B Home/End (Mod1-g/Mod1-Shift-g)
-Select the first/last item.
-.TP
-.B Tab (Control-i)
+.B Tab (Control\-i)

 Copy the selected item to the input field.
 .TP
 Copy the selected item to the input field.
 .TP

-.B Return
+.B Return (Control\-j)

 Confirm selection and quit (print the selected item to standard output). Returns
 .B 0
 on termination.
 .TP
 Confirm selection and quit (print the selected item to standard output). Returns
 .B 0
 on termination.
 .TP

-.B Shift-Return (Control-j)
-Confirm selection and quit (print the text in the input field to standard output).
+.B Shift\-Return (Control\-Shift\-j)
+Confirm input and quit (print the text in the input field to standard output).

 Returns
 .B 0
 on termination.
 .TP
 Returns
 .B 0
 on termination.
 .TP

-.B Escape (Control-bracketleft)
+.B Escape (Control\-c)

 Quit without selecting an item. Returns
 .B 1
 on termination.
 .TP
 Quit without selecting an item. Returns
 .B 1
 on termination.
 .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.
+.B Control\-y
+Pastes the X selection into the input field. This requires
+.BR sselp (1).

 .SH SEE ALSO
 .BR dwm (1),
 .SH SEE ALSO
 .BR dwm (1),

-.BR wmii (1) .
+.BR wmii (1).