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, copyright)
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 that whose configuration file defines these bindings.
78 .SS Globally available bindings
82 .SS Bindings operating on top-level frames and screens and their children
84 BINDINGS:WMPlex.toplevel
86 .SS Bindings operating on frames and screens and their children
90 .SS Bindings operating on all frames (including transient) and their children
94 .SS Bindings operating on top-level (non-transient) frames and their children
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
113 .SS Move/resize mode bindings
115 BINDINGS:WMoveresMode
117 .SS Bindings for message boxes and queries [mod_query]
121 .SS Bindings for editing in queries [mod_query]
123 These bindings are similar to those of the \fIjoe(1)\fP text editor.
124 Cut, copy and paste works in a more conventional manner, though, but
125 the keys are equivalent.
129 .SS Bindings for menus [mod_menu]
134 .SH FILES AND DIRECTORIES
136 .B ETCDIR/cfg_ion.lua
137 System default main configuration files
140 Other configuration files.
143 Colour scheme configuration files
146 User configuration files
148 .B ~/.ion3/cfg_ion.lua
149 User default main configuration file (overrides system default)
152 The Ion home page, \fIhttp://iki.fi/tuomov/ion/\fP
154 The document "Ion: Configuring and extending with Lua" found on the
159 \fIX(7x)\fP, \fIpwm3(1)\fP, \fIjoe(1)\fP
162 Ion was written by Tuomo Valkonen <tuomov at iki.fi>.