3 Ion - an X11 window manager
9 Ion is a tiling tabbed window manager designed with keyboard users in mind.
13 .B \-display host:display.screen
16 .B \-conffile configfile
17 Configuration file to use instead of default
20 Directory to search for configuration files and other scripts
23 On X servers with multiple (traditional non-Xinerama) screens, manage only
24 default screen (root window), not all, as given by the -display option or
25 in the DISPLAY environment variable.
27 .B \-session session_name
28 Set session name. This option affects where workspace and other save files are
29 put (~/.ion3/session_name if option set).
32 Show help on command line options
38 Show about text (version, author, license)
42 This section is an overview of the types objects that appear on an X
43 display managed by Ion and their relationships in a standard setup. This
44 information is necessary to understand the operations and availability
45 of the different key bindings explained below. For a more detailed
46 explanation, needed for writing custom bindings configuration files,
47 see the additional documentation available from the Ion Web page.
49 The top-level objects that matter in the case at hand are \fBscreens\fP.
50 They correspond to physical screens. Screens contain \fBworkspaces\fP
51 (which are a kind of \fBgroup\fP), and \fBclient windows\fP put into full
52 screen mode. These objects are \fBmultiplexed\fP in the sense that only
53 one can be displayed at a time.
55 Workspaces themselves may contain \fBtilings\fP and detached/floating
56 \fBframes\fP. Tilings themselves contain \fBframes\fP tiled to fill the
57 screen, and possibly a statusbar or dock. Akin to screens, frames multiplex
58 other objects, but in this case mostly client window \fBgroups\fP. Most of
59 the time, frames are the only trace of Ion you see on the screen. Frames
60 may have border decorations, and they have a \fBtab\fP for each multiplexed
63 \fBQueries\fP are boxes that appear at the bottoms of frames or screens
64 to ask you for textual input to execute an action that depends on it.
65 Most queries support tab-completion.
70 These are the default key and pointer bindings. (\fBMod1\fP) depends on your
71 system. On PC:s with XFree86 it is probably bound to the left Alt key
72 (\fBAlt_L\fP). On Suns it is usually bound to the diamond keys
73 (\fBMeta_L\fP, \fBMeta_R\fP). Use \fIxmodmap(1x)\fP to find out.
75 The string in square brackets after a binding group heading below indicates
76 the module whose configuration file defines these bindings.
78 .SS Globally available bindings
82 .SS Bindings operating on all frames and screens
86 .SS Bindings operating on all frames
90 .SS Bindings operating on top-level (non-transient) frames and screens
92 BINDINGS:WMPlex.toplevel
94 .SS Bindings operating on top-level (non-transient) frames
96 BINDINGS:WFrame.toplevel
98 .SS Bindings for floating/detached frames
100 BINDINGS:WFrame.floating
102 .SS Bindings for tilings and tiled frames [mod_tiling]
105 .\" BINDINGS:WFrame.tiled
107 .SS Bindings for client windows
112 .SS Move/resize mode bindings
114 BINDINGS:WMoveresMode
116 .SS Bindings for message boxes and queries [mod_query]
120 .SS Bindings for editing in queries [mod_query]
122 These bindings are similar to those of the \fIjoe(1)\fP text editor.
123 Cut, copy and paste works in a more conventional manner, though, but
124 the keys are equivalent.
128 .SS Bindings for menus [mod_menu]
133 .SH FILES AND DIRECTORIES
135 .B ETCDIR/cfg_ion.lua
136 System default main configuration files
139 Other configuration files.
142 Colour scheme configuration files
145 User configuration files
147 .B ~/.ion3/cfg_ion.lua
148 User default main configuration file (overrides system default)
151 The Ion home page, \fIhttp://iki.fi/tuomov/ion/\fP
153 The document "Configuring and extending Ion3 with Lua" found on the
158 \fIX(7x)\fP, \fIpwm3(1)\fP, \fIjoe(1)\fP
161 Ion was written by Tuomo Valkonen <tuomov at iki.fi>.