Install Debian's ion_0.0.20020207-1.diff.gz patch.
[ion1.git] / man / ion.1x.in
blob6958bdff6ecbbf99e13eab3cd6c7a74f2134a603
1 .TH ION 1
2 .SH NAME
3 Ion - an X11 window manager
4 .SH SYNOPSIS
5 .B ion
6 .I "[options]"
7 .SH "DESCRIPTION"
8 Ion is an X11 window manager with text-editorish and keyboard friendly feel.
9 .SH "OPTIONS"
10 .TP
11 .B \-display host:display.screen
12 X display to manage
13 .TP
14 .B \-cfgfile configfile
15 Config file to use instead of default
16 .TP
17 .B \-onescreen
18 On X servers with multiple screens, manage only default screen, not all.
19 .TP
20 .B \-help
21 Show help on command line options
22 .TP
23 .B \-version
24 Show version
25 .TP
26 .B \-about
27 Show about text
29 .SH KEYS
31 These are the default keybindings.
32 .B Mod1
33 depends on your system. On PC:s with XFree86 it is probably bound to the left
34 alt key (\fBAlt_L\fP).
35 On Suns it is usually bound to the diamond keys (\fBMeta_L\fP, \fBMeta_R\fP). Use
36 \fIxmodmap(1x)\fP to find out.
38 .SS F-keys
40 .TP
41 .B F1
42 Show manual page (query, uses ion-man).
43 .TP
44 .B Mod1+F1
45 Show Ion manual page.
46 .TP
47 .B F2
48 Run an x-terminal-emulator.
49 .TP
50 .B F3
51 Run a program (query). Precede the program name with a colon (:) to run in xterm (ion-runinxterm).
52 .TP
53 .B Mod1+F3
54 Call a function (query).
55 .TP
56 .B F4
57 Start new SSH session (query, uses ion-ssh).
58 .TP
59 .B F5
60 Open a file for editing (query). Uses ion-edit which by default uses run-mailcap.
61 .TP
62 .B F6
63 Open a file for viewing (query). Uses ion-view which by default uses run-mailcap.
64 .TP
65 .B F9
66 Goto existing workspace or create new (query).
67 .TP
68 .B Mod1+F9
69 Create new workspace with active client.
70 .TP
71 .B F11
72 Restart Ion (query)
73 .TP
74 .B F12
75 Exit Ion (query)
77 .SS Navigation
79 .TP
80 .B Mod1+N
81 Goto below frame
82 .TP
83 .B Mod1+P
84 Goto above frame
85 .TP
86 .B Mod1+Tab
87 Goto right frame
88 .TP
89 .B Mod1+K Tab
90 Goto left frame
91 .TP
92 .B Mod1+n
93 Goto n:th workspace (n=1..9, 0)
94 .TP
95 .B Mod1+K N
96 Goto next client within frame
97 .TP
98 .B Mod1+K P
99 Goto previous client within frame
101 .B Mod1+K n
102 Goto n:th client within frame (n=1..9, 0)
104 .B Mod1+K K
105 Goto previously active client
107 .B Mod1+A
108 Attach client in current frame (query)
110 .B Mod1+G
111 Goto client (query)
114 .SS Resize and split
117 .B Mod1+V
118 Resize vertically. In resize-mode, use \fBS\fP to shrink, \fBV\fP to grow and \fBEnter\fP to
119 finish before timeout (1.5s by default).
121 .B Mod1+H
122 Resize horizontally
124 .B Mod1+K V
125 Maximize vertically
127 .B Mod1+K H
128 Maximize horizontally
130 .B Mod1+S
131 Split vertically
133 .B Mod1+K S
134 Split horizontally
136 .SS Close and all
139 .B Mod1+C
140 Close client or destroy empty frame
142 .B Mod1+K C
143 Kill client
145 .B Mod1+K X
146 Destroy frame
148 .SH LINE-EDITING KEYS
150 These keys can be used in the line editor (queries). They are similar to
151 those of \fIjoe(1)\fP.
152 Selection works differently, though, while the keys are equivalent.
154 .SS Movement
157 .B Control+F, Right arrow
158 Go forward character
160 .B Control+B, Left arrow
161 Go backward character
163 .B Control+E, End
164 Go to end of line
166 .B Control+A, Home
167 Go to beginning of line
169 .B Control+Z
170 Backward skip word
172 .B Control+X
173 Forward skip word
175 .SS Delete
178 .B Control+D, Delete
179 Delete next character
181 .B Control+H, Backspace
182 Delete previous character
184 .B Control+J
185 Delete to end of line
187 .B Control+Y
188 Delete whole line
190 .B Control+W
191 Delete word
193 .B Control+O
194 Backward delete word
196 .SS Selections
199 .B Control+K B
200 Set mark (begin selection)
202 .B Control+K K
203 Copy selection
205 .B Control+K Y
206 Cut selection
208 .B Control+K C
209 Paste
211 .SS Completion and history
214 .B Tab
215 Complete or list possible completions (if available)
217 .B Control+U, Page up
218 Scroll completions up
220 .B Control+V, Page down
221 Scroll completions down
223 .B Control+P, Up arrow
224 Previous history entry
226 .B Control+N, Down arrow
227 Next history entry
229 .SS Cancel, accept
232 .B Control+C, Escape
233 Cancel
235 .B Control+M, Enter
236 Accept
238 .SH BUTTONS
241 .B Button1 (left)
242 Click on tab: switch client. Drag tab: move clients between frames.
244 .B Button3 (right)
245 Drag border: resize.
247 .SH FILES
249 .B ETCDIR/ion/ion.conf
250 System default configuration file
252 .B ETCDIR/ion/look-*.conf
253 Color scheme configuration files
255 .B ETCDIR/ion/bindings-*.conf
256 Keyboard and pointer binding configuration files
258 .B ~/.ion/ion.conf
259 User default configuration file (overrides system default)
261 .SH SEE ALSO
262 The Ion home page, \fIhttp://www.students.tut.fi/~tuomov/ion/\fP
264 .I DOCDIR/ion/
266 .I X(1x)
267 .SH AUTHOR
268 Ion was written by Tuomo Valkonen <tuomov@cc.tut.fi>.