made dmenu.1 also concise

[dmenu.git] / dmenu.1

diff --git a/dmenu.1 b/dmenu.1
index 354a75e..fa3adc0 100644 (file)
--- a/dmenu.1
+++ b/dmenu.1
@@ -1,4 +1,4 @@
-.TH DMENU 1 d-0.0
+.TH DMENU 1 dmenu-VERSION

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


@@ -6,60 +6,57 @@ dmenu \- dynamic menu
 .RB [ \-v ]
 .SH DESCRIPTION
 .SS Overview
 .RB [ \-v ]
 .SH DESCRIPTION
 .SS Overview

-.B dmenu
-is a generic, highly customizable, and efficient menu for the X Window System,
-originally designed for
+dmenu is a generic menu for X, originally designed for

 .BR dwm (1).
 .BR dwm (1).

-It supports arbitrary, user defined menu contents.
+It manages huge amounts (up to 10.000 and more) of user defined menu items
+efficiently.

 .SS Options
 .TP
 .B \-v
 .SS Options
 .TP
 .B \-v

-prints version information to stdout, then exits.
-.SS Usage
-.B 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 Enter, his choice
-is printed to stdout and
-.B dmenu
-terminates.
-.SS Keyboard Control 
-.B dmenu
-is completely controlled by the keyboard.  The following keys are recognized:
-.TP 2
-Any printable character
-appends the character to the text in the input field. This works as a filter:
+prints version information to standard output, then exits.
+.SH USAGE
+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
+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.
 only items containing this text will be displayed.

-.TP 2
-Left/Right (Control-p/Control-n)
-select the previous/next item.
-.TP 2
-Tab (Control-i)
-copy the selected item to the input field.
-.TP 2
-Enter (Control-j)
-confirm selection and quit (print the selected item to stdout).
-.TP 2
-Shift-Enter (Shift-Control-j)
-confirm selection and quit (print the text in the input field to stdout).
-.TP 2
-Escape (Control-[)
-quit without selecting an item.
-.TP 2
-Backspace (Control-h)
-remove enough characters from the input field to change its filtering effect.
-.TP 2
-Control-u
-remove all characters from the input field.
-.SS Exit codes
-.B dmenu
-returns
+.TP
+.B Left/Right
+Select the previous/next item.
+.TP
+.B Tab
+Copy the selected item to the input field.
+.TP
+.B Return
+Confirm selection and quit (print the selected item to standard output).
+.TP
+.B Shift-Return
+Confirm selection and quit (print the text in the input field to standard output).
+.TP
+.B Escape
+Quit without selecting an item.
+.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.
+.P
+dwm returns

 .B 0
 .B 0

-if Enter is pressed on termination,
+if
+.B Return
+is pressed and

 .B 1
 .B 1

-if Escape is pressed.
+if
+.B Escape
+is pressed on termination.

 .SH CUSTOMIZATION
 .SH CUSTOMIZATION

-.B dmenu
-is customized by creating a custom config.h and (re)compiling the source
+dmenu is customized by creating a custom config.h and (re)compiling the source

 code. This keeps it fast, secure and simple.
 .SH SEE ALSO
 .BR dwm (1)
 code. This keeps it fast, secure and simple.
 .SH SEE ALSO
 .BR dwm (1)