[svn-upgrade] Integrating new upstream version, ion3 (20080207)

[ion3.git] / etc / cfg_ion.lua

diff --git a/etc/cfg_ion.lua b/etc/cfg_ion.lua
index 726d6546768c97e447bdc129d6c4b13b2d09290a..c16103ad80e0b66f517c3e425c605b711e397e1d 100644 (file)
--- a/etc/cfg_ion.lua
+++ b/etc/cfg_ion.lua
@@ -3,7 +3,14 @@
 --
 -- This file only includes some settings that are rather frequently altered.
 -- The rest of the settings are in cfg_ioncore.lua and individual modules'
--- configuration files (cfg_modulename.lua).
+-- configuration files (cfg_modulename.lua). 
+--
+-- When any binding and other customisations that you want are minor, it is 
+-- recommended that you include them in a copy of this file in ~/.ion3/.
+-- Simply create or copy the relevant settings at the end of this file (from
+-- the other files), recalling that a key can be unbound by passing 'nil' 
+-- (without the quotes) as the callback. For more information, please see 
+-- the Ion configuration manual available from the Ion Web page.
 --
 
 -- Set default modifiers. Alt should usually be mapped to Mod1 on
@@ -57,7 +64,7 @@ ioncore.set{
 -- modules with 'mod' replaced by 'cfg'.
 dopath("cfg_defaults")
 
--- Load configuration of the Ion 'core'
+-- Load configuration of the Ion 'core'. Most bindings are here.
 --dopath("cfg_ioncore")
 
 -- Load some kludges to make apps behave better.
@@ -66,7 +73,8 @@ dopath("cfg_defaults")
 -- Define some layouts. 
 --dopath("cfg_layouts")
 
--- Load some modules. 
+-- Load some modules. Bindings and other configuration specific to modules
+-- are in the files cfg_modulename.lua.
 --dopath("mod_query")
 --dopath("mod_menu")
 --dopath("mod_tiling")