dmenu-noxz

[fork] suckless dmenu - personal fork
git clone https://noxz.tech/git/dmenu-noxz.git
Log | Files | README | LICENSE

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