diff options
-rw-r--r-- | dmenu.1 | 45 |
1 files changed, 22 insertions, 23 deletions
@@ -15,46 +15,45 @@ It supports arbitrary, user defined menu contents. | |||
15 | .TP | 15 | .TP |
16 | .B \-v | 16 | .B \-v |
17 | prints version information to stdout, then exits. | 17 | prints version information to stdout, then exits. |
18 | .SS Usage | 18 | .SH USAGE |
19 | .B dmenu | 19 | .B dmenu |
20 | reads a list of newline-separated items from stdin and creates a menu. | 20 | reads a list of newline-separated items from stdin and creates a menu. |
21 | When the user selects an item or enters any text and presses Enter, his choice | 21 | When the user selects an item or enters any text and presses Return, his choice |
22 | is printed to stdout and | 22 | is printed to stdout and |
23 | .B dmenu | 23 | .B dmenu |
24 | terminates. | 24 | terminates. |
25 | .SS Keyboard Control | ||
26 | .B dmenu | 25 | .B dmenu |
27 | is completely controlled by the keyboard. The following keys are recognized: | 26 | is completely controlled by the keyboard. The following keys are recognized: |
28 | .TP 2 | 27 | .TP |
29 | Any printable character | 28 | Any printable character |
30 | appends the character to the text in the input field. This works as a filter: | 29 | Appends the character to the text in the input field. This works as a filter: |
31 | only items containing this text will be displayed. | 30 | only items containing this text will be displayed. |
32 | .TP 2 | 31 | .TP |
33 | Left/Right (Control-p/Control-n) | 32 | Left/Right (Control-p/Control-n) |
34 | select the previous/next item. | 33 | Select the previous/next item. |
35 | .TP 2 | 34 | .TP |
36 | Tab (Control-i) | 35 | Tab (Control-i) |
37 | copy the selected item to the input field. | 36 | Copy the selected item to the input field. |
38 | .TP 2 | 37 | .TP |
39 | Enter (Control-j) | 38 | Return (Control-j) |
40 | confirm selection and quit (print the selected item to stdout). | 39 | Confirm selection and quit (print the selected item to stdout). |
41 | .TP 2 | 40 | .TP |
42 | Shift-Enter (Shift-Control-j) | 41 | Shift-Return (Shift-Control-j) |
43 | confirm selection and quit (print the text in the input field to stdout). | 42 | Confirm selection and quit (print the text in the input field to stdout). |
44 | .TP 2 | 43 | .TP |
45 | Escape (Control-[) | 44 | Escape (Control-[) |
46 | quit without selecting an item. | 45 | Quit without selecting an item. |
47 | .TP 2 | 46 | .TP |
48 | Backspace (Control-h) | 47 | Backspace (Control-h) |
49 | remove enough characters from the input field to change its filtering effect. | 48 | Remove enough characters from the input field to change its filtering effect. |
50 | .TP 2 | 49 | .TP |
51 | Control-u | 50 | Control-u |
52 | remove all characters from the input field. | 51 | Remove all characters from the input field. |
53 | .SS Exit codes | 52 | .P |
54 | .B dmenu | 53 | .B dmenu |
55 | returns | 54 | returns |
56 | .B 0 | 55 | .B 0 |
57 | if Enter is pressed on termination, | 56 | if Return is pressed on termination, |
58 | .B 1 | 57 | .B 1 |
59 | if Escape is pressed. | 58 | if Escape is pressed. |
60 | .SH CUSTOMIZATION | 59 | .SH CUSTOMIZATION |