X-Git-Url: https://git.decadent.org.uk/gitweb/?p=ion3-doc.git;a=blobdiff_plain;f=conf.tex;h=6ec99ecc0303a06e2d591749021c3e5598aca516;hp=109093bdf49b659152fa7a1a7db417bc32b90d34;hb=6121e0e6f3aea3e43bf6d432fdd474566fd08a16;hpb=6e84dc8312f2fdb5b8b7467a0279afd5b2df107f diff --git a/conf.tex b/conf.tex index 109093b..6ec99ec 100644 --- a/conf.tex +++ b/conf.tex @@ -11,12 +11,12 @@ before continuing with this chapter. Section \ref{sec:conffiles} is an overview of the multiple configuration files Ion uses and as a perhaps more understandable introduction to the general layout of the configuration files, a walk-through of the main -configuration file \file{ion.lua} is provided in section +configuration file \file{cfg\_ion.lua} is provided in section \ref{sec:walkthrough}. How keys and mouse action are bound to functions is described in detail in \ref{sec:bindings} and in section \ref{sec:winprops} winprops are -explained. For a reference on exported functions, see section -\ref{sec:exports}. +explained. Finally, the statusbar is explained in \ref{sec:statusbar}. +For a reference on exported functions, see section \ref{sec:exports}. \section{The configuration files} \label{sec:conffiles} @@ -40,14 +40,20 @@ configuration file directory for files. Therefore, if you want to change some setting, it is advised against that you modify the stock configuration files in-place as subsequent installs of Ion will restore the stock configuration files. Instead you should always make a copy of the stock -file in \file{\~{}/.ion3/} and modify this file. When searching -for a file, if no extension or path component is given, compiled \file{.lc} -files are attempted before \file{.lua} files. +file in \file{\~{}/.ion3/} and modify this file. For sake of maintainability +of your customised configuration, it is recommended against copying all of +the files there. Only copy those files you actually need to modify. Most +simple customisations, such as changes in a few bindings, are best done +entirely within \file{cfg\_ion.lua}. -All the configuration files are named \file{cfg\_*.lua} with the ''\file{*}'' +All the configuration files are named \file{cfg\_*.lua} with the ``\file{*}'' part varying. The configuration file for each module \file{mod\_modname} is \file{cfg\_modname.lua}, with \file{modname} varying by the module in -question. The following table summarises these and other configuration +question. Configuration files can also be compiled into \file{.lc} files, +and these are attempted by the configuration file search routines before +\file{.lua} files. + +The following table summarises these and other configuration files: \begin{tabularx}{\linewidth}{ @@ -69,6 +75,9 @@ files: Settings to get some applications behave more nicely have been collected here. See section \ref{sec:winprops}. \\ % + \file{cfg\_layouts.lua} & + Some workspace layouts are defined here. \\ + % \file{cfg\_tiling.lua} \file{cfg\_query.lua} \file{cfg\_menu.lua} @@ -88,19 +97,21 @@ file. Some basic 'feel' settings are usually configured there and the necessary modules and other configuration files configuring some more specific aspects of Ion are loaded there. In this section we take a walk through the stock \file{cfg\_ion.lua}. -Notice that most of the settings are commented-out (\code{--} is a +Notice that most of the settings are commented-out (\verb!--! is a line comment in Lua) in the actual file, as they're the defaults nevertheless. -The first thing one in the file is to set +The first thing done in the file, is to set \begin{verbatim} META="Mod1+" ALTMETA="" \end{verbatim} These settings cause most of Ion's key bindings to use \key{Mod1} as the -modifier key. If \code{ALTMETA} is set, it is used as modifier for the keys -that don't normally use a modifier. for details on modifiers and key -binding setup in general see section \ref{sec:bindings}. +modifier key. If \code{ALTMETA} is set, it is used as modifier for the +keys that don't normally use a modifier. Note that these two are Lua +variables used in the configuration files only, and not Ion settings. +For details on modifiers and key binding setup in general, see section +\ref{sec:bindings}. Next we do some basic feel configuration: @@ -125,20 +136,30 @@ The first of these two settings enables opaque resize mode: in move/resize move frames and other objects mirror you actions immediately. If opaque resize is disabled, a XOR rubber band is shown during the mode instead. This will, unfortunately, cause Ion to also grab the X server and has some -side effects. +side effects. -Next we load the configuration for Ion's core, and some kludges: +There are some other options as well; see the documentation +for \fnref{ioncore.set} for details. + +As a next step, in the actual \file{cfg\_ion.lua} file, we load +\file{cfg\_defaults.lua}. However, it is merely a convenience file for +doing exactly what we will going through below, and what is commented +out in the actual file. If you do not want to load what +\file{cfg\_defaults.lua} loads, just comment out the corresponding +line, and uncomment the lines for the files that you want: \begin{verbatim} +--dopath("cfg_defaults") dopath("cfg_ioncore") dopath("cfg_kludges") +dopath("cfg_layouts") \end{verbatim} Most bindings and menus are defined in \file{cfg\_ioncore.lua}. Details on making such definitions follow in sections \ref{sec:bindings} and \ref{sec:menus}, respectively. -some kludges or ''winprops'' to make some applications behave better -under Ion are colledted in \file{cfg\_kludges.lua}; see section +some kludges or ``winprops'' to make some applications behave better +under Ion are collected in \file{cfg\_kludges.lua}; see section \ref{sec:winprops} for details. In addition to these, this file lists quite a few statements of the form \begin{verbatim} @@ -150,29 +171,28 @@ expression that is used to match against the title and the next is a rule to construct a new title of a match occurs. This particular rule is used to shorten e.g. 'Foo: barbaz<3>' to 'barba{\ldots}<3>'; for details see the function reference entry for \fnref{ioncore.defshortening}. +Finally, \file{cfg\_layouts.lua} defines some workspace layouts, available +through the \key{F9} workspace creation query. To actually be able to do something besides display windows in full screen mode, we must next load some modules: \begin{verbatim} -dopath("cfg_modules") ---dopath("mod_query") ---dopath("mod_menu") ---dopath("mod_tiling") ---dopath("mod_statusbar") +dopath("mod_query") +dopath("mod_menu") +dopath("mod_tiling") +dopath("mod_statusbar") --dopath("mod_dock") ---dopath("mod_sp") +dopath("mod_sp") \end{verbatim} -We actually load there another file listing the default selection of -modules. If you only want to load additional modules, just uncomment -the corresponding line. If you want to disable loading some modules, -comment out the the line loading \file{cfg\_modules}, and uncomment -the lines for the modules you want, or add more. - \input{conf-bindings.tex} \input{conf-menus.tex} \input{conf-winprops.tex} + +\input{conf-statusbar.tex} + +