]> git.decadent.org.uk Git - ion3.git/blobdiff - etc/cfg_ion.lua
Update cfg_kludge_flash for Flash 10
[ion3.git] / etc / cfg_ion.lua
index d1255e5807368c8f85be51113240e38b8fa02e38..c16103ad80e0b66f517c3e425c605b711e397e1d 100644 (file)
@@ -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
@@ -32,6 +39,20 @@ ioncore.set{
     -- Movement commands warp the pointer to frames instead of just
     -- changing focus. Enabled by default.
     --warp=true,
+    
+    -- Switch frames to display newly mapped windows
+    --switchto=true,
+    
+    -- Default index for windows in frames: one of 'last', 'next' (for
+    -- after current), or 'next-act' (for after current and anything with
+    -- activity right after it).
+    --frame_default_index='next',
+    
+    -- Auto-unsqueeze transients/menus/queries.
+    --unsqueeze=true,
+    
+    -- Display notification tooltips for activity on hidden workspace.
+    --screen_notify=true,
 }
 
 
@@ -39,9 +60,11 @@ ioncore.set{
 -- commented out below, except mod_dock. If you do not want to load
 -- something, comment out this line, and uncomment the lines corresponding
 -- the the modules or configuration files that you want, below.
+-- The modules' configuration files correspond to the names of the 
+-- 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.
@@ -50,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")
@@ -58,3 +82,19 @@ dopath("cfg_defaults")
 --dopath("mod_dock")
 --dopath("mod_sp")
 
+
+--
+-- Common customisations
+--
+
+-- Uncommenting the following lines should get you plain-old-menus instead
+-- of query-menus.
+
+--defbindings("WScreen", {
+--    kpress(ALTMETA.."F12", "mod_menu.menu(_, _sub, 'mainmenu', {big=true})"),
+--})
+--
+--defbindings("WMPlex.toplevel", {
+--    kpress(META.."M", "mod_menu.menu(_, _sub, 'ctxmenu')"),
+--})
+