]> git.decadent.org.uk Git - ion3-doc.git/commitdiff
[svn-upgrade] Integrating new upstream version, ion3 (20070927) ion3-20070927
authorBen Hutchings <ben@decadent.org.uk>
Thu, 27 Sep 2007 21:20:29 +0000 (21:20 +0000)
committerBen Hutchings <ben@decadent.org.uk>
Thu, 27 Sep 2007 21:20:29 +0000 (21:20 +0000)
18 files changed:
ChangeLog
conf.tex
exact-version
ionconf.dvi.gz
ionconf.ps.gz
ionconf.tex
ionconf/images.log
ionconf/images.tex
ionconf/index.html
ionconf/ionconf.html
ionconf/node11.html
ionconf/node13.html
ionconf/node4.html
ionconf/node5.html
ionconf/node7.html
ionnotes.dvi.gz
ionnotes.ps.gz
ionnotes/node9.html

index 02a662260b254931f69957c249fdfeab3efde8ae..bf16748e7ea00024f252ead5e3bb2e60fccf9326 100644 (file)
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,9 @@
+2007-09-27 16:23 UTC  Tuomo Valkonen <tuomov@iki.fi>
+  tagged ion-doc-3rc-20070927
+
+2007-09-11 07:40 UTC  Tuomo Valkonen <tuomov@iki.fi>
+  * Notes on config file modification
+
 2007-09-02 13:41 UTC  Tuomo Valkonen <tuomov@iki.fi>
   tagged ion-doc-3rc-20070902
 
index ed19b517b91c7b47b8c7af03822170900f376d2f..6ec99ecc0303a06e2d591749021c3e5598aca516 100644 (file)
--- a/conf.tex
+++ b/conf.tex
@@ -11,7 +11,7 @@ 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
@@ -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{*}''
 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}{
index 61e00242dbb6349edaa8864af93b7f748f9e7a5c..b4bfe8cc6649b81224b1e325efcb2c04b2cf7ac7 100644 (file)
@@ -1,5 +1,5 @@
 
 Context:
 
-[TAG ion-doc-3rc-20070902
-Tuomo Valkonen <tuomov@iki.fi>**20070902134120
+[TAG ion-doc-3rc-20070927
+Tuomo Valkonen <tuomov@iki.fi>**20070927162337
index 2691a1c70446b7cb168299ed6800a5400b0b05d4..4c8973bc855f5dff0956744860bb0867bf446737 100644 (file)
Binary files a/ionconf.dvi.gz and b/ionconf.dvi.gz differ
index 01966e8c3455c0cdf82a78b03b66e56dff4fed8c..ae751c6bb34facd2c63fdb3be77f165de5717e05 100644 (file)
Binary files a/ionconf.ps.gz and b/ionconf.ps.gz differ
index cd491eb6d497d164d251f28337af1333addff421..aa4aaa690d13db16ebf9ac4233620d8e0ce2fccb 100644 (file)
@@ -10,7 +10,7 @@
 
 \title{Configuring and extending Ion3 with Lua}
 \author{Tuomo Valkonen \\ tuomov at iki.fi}
-\date{2007-09-02}
+\date{2007-09-27}
 
 \makeindex
 
index 0ee24bcb3a7ccf91e4ae2f1ff98298b57e199d5b..7dcd34b5625534dea4ad019d837e530d06e80f3c 100644 (file)
@@ -1,4 +1,4 @@
-This is pdfeTeX, Version 3.141592-1.21a-2.2 (Web2C 7.5.4) (format=latex 2007.4.8)  2 SEP 2007 16:45
+This is pdfeTeX, Version 3.141592-1.21a-2.2 (Web2C 7.5.4) (format=latex 2007.4.8)  27 SEP 2007 19:26
 entering extended mode
 **./images.tex
 (./images.tex
@@ -353,33 +353,33 @@ LaTeX Font Info:    External font `cmex10' loaded for size
 (Font)              <8> on input line 235.
 LaTeX Font Info:    External font `cmex10' loaded for size
 (Font)              <6> on input line 235.
-l2hSize :tex2html_wrap_inline1055:7.0626pt::0.0pt::7.1201pt.
+l2hSize :tex2html_wrap_inline1059:7.0626pt::0.0pt::7.1201pt.
 [1
 
 
 
 ]
-l2hSize :tex2html_wrap_inline1059:7.48248pt::0.0pt::48.86426pt.
+l2hSize :tex2html_wrap_inline1063:7.48248pt::0.0pt::48.86426pt.
 [2
 
 
 ]
-l2hSize :tex2html_wrap_inline2259:8.7125pt::8.7125pt::23.6642pt.
+l2hSize :tex2html_wrap_inline2263:8.7125pt::8.7125pt::23.6642pt.
 [3
 
 
 ]
-l2hSize :tex2html_wrap_inline5536:7.5626pt::7.5626pt::14.53923pt.
+l2hSize :tex2html_wrap_inline5540:7.5626pt::7.5626pt::14.53923pt.
 [4
 
 
 ]
-l2hSize :tex2html_wrap_inline5538:7.5626pt::7.5626pt::14.53923pt.
+l2hSize :tex2html_wrap_inline5542:7.5626pt::7.5626pt::14.53923pt.
 [5
 
 
 ]
-l2hSize :tex2html_wrap_inline7788:8.7125pt::8.7125pt::86.9574pt.
+l2hSize :tex2html_wrap_inline7792:8.7125pt::8.7125pt::86.9574pt.
 [6
 
 
index 81b705320d7f3e46d7dc69806650e90aa88b21b3..ebd32e5e03077731604127703b33da65be9a1592 100644 (file)
@@ -82,7 +82,7 @@
 
 \title{Configuring and extending Ion3 with Lua}
 \author{Tuomo Valkonen \\tuomov at iki.fi}
-\date{2007-09-02}
+\date{2007-09-27}
 
 
 \makeindex
 \stepcounter{section}
 \stepcounter{section}
 {\newpage\clearpage
-\lthtmlinlinemathA{tex2html_wrap_inline1055}%
+\lthtmlinlinemathA{tex2html_wrap_inline1059}%
 $n$%
 \lthtmlinlinemathZ
 \lthtmlcheckvsize\clearpage}
@@ -242,7 +242,7 @@ $n$%
 \stepcounter{subsection}
 \stepcounter{subsection}
 {\newpage\clearpage
-\lthtmlinlinemathA{tex2html_wrap_inline1059}%
+\lthtmlinlinemathA{tex2html_wrap_inline1063}%
 $N=1{\ldots} 5$%
 \lthtmlinlinemathZ
 \lthtmlcheckvsize\clearpage}
@@ -301,7 +301,7 @@ $N=1{\ldots} 5$%
 \stepcounter{subsection}
 \stepcounter{subsection}
 {\newpage\clearpage
-\lthtmlinlinemathA{tex2html_wrap_inline2259}%
+\lthtmlinlinemathA{tex2html_wrap_inline2263}%
 $(0, 1]$%
 \lthtmlinlinemathZ
 \lthtmlcheckvsize\clearpage}
@@ -325,13 +325,13 @@ $(0, 1]$%
 \stepcounter{subsection}
 \stepcounter{subsection}
 {\newpage\clearpage
-\lthtmlinlinemathA{tex2html_wrap_inline5536}%
+\lthtmlinlinemathA{tex2html_wrap_inline5540}%
 $-1$%
 \lthtmlinlinemathZ
 \lthtmlcheckvsize\clearpage}
 
 {\newpage\clearpage
-\lthtmlinlinemathA{tex2html_wrap_inline5538}%
+\lthtmlinlinemathA{tex2html_wrap_inline5542}%
 $-2$%
 \lthtmlinlinemathZ
 \lthtmlcheckvsize\clearpage}
@@ -361,7 +361,7 @@ $-2$%
 \stepcounter{section}
 \stepcounter{subsection}
 {\newpage\clearpage
-\lthtmlinlinemathA{tex2html_wrap_inline7788}%
+\lthtmlinlinemathA{tex2html_wrap_inline7792}%
 $\{t,m,b\}\times\{t,c,b\}$%
 \lthtmlinlinemathZ
 \lthtmlcheckvsize\clearpage}
index e1cb79b44afda9dd163d67b250b298db461c860f..0ea44a0b9d1a46ee81e00a19b9db1acca5823f43 100644 (file)
@@ -57,7 +57,7 @@ original version by:  Nikos Drakos, CBLU, University of Leeds
 
 <P ALIGN="CENTER"><STRONG>Tuomo Valkonen</STRONG></P>
 <P ALIGN="CENTER"><I>tuomov at iki.fi</I></P>
-<P ALIGN="CENTER"><STRONG>2007-09-02</STRONG></P>
+<P ALIGN="CENTER"><STRONG>2007-09-27</STRONG></P>
 </DIV>
 
 <P>
index e1cb79b44afda9dd163d67b250b298db461c860f..0ea44a0b9d1a46ee81e00a19b9db1acca5823f43 100644 (file)
@@ -57,7 +57,7 @@ original version by:  Nikos Drakos, CBLU, University of Leeds
 
 <P ALIGN="CENTER"><STRONG>Tuomo Valkonen</STRONG></P>
 <P ALIGN="CENTER"><I>tuomov at iki.fi</I></P>
-<P ALIGN="CENTER"><STRONG>2007-09-02</STRONG></P>
+<P ALIGN="CENTER"><STRONG>2007-09-27</STRONG></P>
 </DIV>
 
 <P>
index 0b36dafb8e7de68f087fa4597b7e04e69a1b9819..edf9325b9d2f8e922d7f48c902d7f6c32f755804 100644 (file)
@@ -58,112 +58,112 @@ original version by:  Nikos Drakos, CBLU, University of Leeds
 Index</A>
 </H2><HR><DL>
 <DD><STRONG><TT>acrobatic</TT></STRONG>
- : <A HREF="node4.html#1458"><SPAN CLASS="arabic">3</SPAN>.<SPAN CLASS="arabic">5</SPAN></A>
+ : <A HREF="node4.html#1462"><SPAN CLASS="arabic">3</SPAN>.<SPAN CLASS="arabic">5</SPAN></A>
 <DD><STRONG><SPAN  CLASS="textbf">Alt</SPAN></STRONG>
- : <A HREF="node4.html#883"><SPAN CLASS="arabic">3</SPAN>.<SPAN CLASS="arabic">3</SPAN>.<SPAN CLASS="arabic">5</SPAN></A>
+ : <A HREF="node4.html#887"><SPAN CLASS="arabic">3</SPAN>.<SPAN CLASS="arabic">3</SPAN>.<SPAN CLASS="arabic">5</SPAN></A>
 <DD><STRONG><SPAN  CLASS="textbf">AnyModifier</SPAN></STRONG>
- : <A HREF="node4.html#881"><SPAN CLASS="arabic">3</SPAN>.<SPAN CLASS="arabic">3</SPAN>.<SPAN CLASS="arabic">5</SPAN></A>
+ : <A HREF="node4.html#885"><SPAN CLASS="arabic">3</SPAN>.<SPAN CLASS="arabic">3</SPAN>.<SPAN CLASS="arabic">5</SPAN></A>
 <DD><STRONG><TT>resizeinc</TT></STRONG>
- : <A HREF="node4.html#1474"><SPAN CLASS="arabic">3</SPAN>.<SPAN CLASS="arabic">5</SPAN>.<SPAN CLASS="arabic">1</SPAN></A>
- | <A HREF="node4.html#1475"><SPAN CLASS="arabic">3</SPAN>.<SPAN CLASS="arabic">5</SPAN>.<SPAN CLASS="arabic">1</SPAN></A>
+ : <A HREF="node4.html#1478"><SPAN CLASS="arabic">3</SPAN>.<SPAN CLASS="arabic">5</SPAN>.<SPAN CLASS="arabic">1</SPAN></A>
+ | <A HREF="node4.html#1479"><SPAN CLASS="arabic">3</SPAN>.<SPAN CLASS="arabic">5</SPAN>.<SPAN CLASS="arabic">1</SPAN></A>
 <DD><STRONG><SPAN  CLASS="textbf">Button-n</SPAN></STRONG>
- : <A HREF="node4.html#887"><SPAN CLASS="arabic">3</SPAN>.<SPAN CLASS="arabic">3</SPAN>.<SPAN CLASS="arabic">6</SPAN></A>
+ : <A HREF="node4.html#891"><SPAN CLASS="arabic">3</SPAN>.<SPAN CLASS="arabic">3</SPAN>.<SPAN CLASS="arabic">6</SPAN></A>
 <DD><STRONG><TT>class</TT></STRONG><DL>
-<DD><STRONG>winprop</STRONG> : <A HREF="node4.html#1481"><SPAN CLASS="arabic">3</SPAN>.<SPAN CLASS="arabic">5</SPAN>.<SPAN CLASS="arabic">2</SPAN></A>
+<DD><STRONG>winprop</STRONG> : <A HREF="node4.html#1485"><SPAN CLASS="arabic">3</SPAN>.<SPAN CLASS="arabic">5</SPAN>.<SPAN CLASS="arabic">2</SPAN></A>
 </DL>
 <DD><STRONG><TT>clientwin_do_manage_alt</TT></STRONG>
- : <A HREF="node7.html#8266"><SPAN CLASS="arabic">6</SPAN>.<SPAN CLASS="arabic">9</SPAN></A>
+ : <A HREF="node7.html#8270"><SPAN CLASS="arabic">6</SPAN>.<SPAN CLASS="arabic">9</SPAN></A>
 <DD><STRONG><TT>clientwin_mapped_hook</TT></STRONG>
- : <A HREF="node7.html#8267"><SPAN CLASS="arabic">6</SPAN>.<SPAN CLASS="arabic">9</SPAN></A>
+ : <A HREF="node7.html#8271"><SPAN CLASS="arabic">6</SPAN>.<SPAN CLASS="arabic">9</SPAN></A>
 <DD><STRONG><TT>clientwin_property_change_hook</TT></STRONG>
- : <A HREF="node7.html#8268"><SPAN CLASS="arabic">6</SPAN>.<SPAN CLASS="arabic">9</SPAN></A>
+ : <A HREF="node7.html#8272"><SPAN CLASS="arabic">6</SPAN>.<SPAN CLASS="arabic">9</SPAN></A>
 <DD><STRONG><TT>clientwin_unmapped_hook</TT></STRONG>
- : <A HREF="node7.html#8269"><SPAN CLASS="arabic">6</SPAN>.<SPAN CLASS="arabic">9</SPAN></A>
+ : <A HREF="node7.html#8273"><SPAN CLASS="arabic">6</SPAN>.<SPAN CLASS="arabic">9</SPAN></A>
 <DD><STRONG><SPAN  CLASS="textbf">Control</SPAN></STRONG>
- : <A HREF="node4.html#879"><SPAN CLASS="arabic">3</SPAN>.<SPAN CLASS="arabic">3</SPAN>.<SPAN CLASS="arabic">5</SPAN></A>
+ : <A HREF="node4.html#883"><SPAN CLASS="arabic">3</SPAN>.<SPAN CLASS="arabic">3</SPAN>.<SPAN CLASS="arabic">5</SPAN></A>
 <DD><STRONG><TT>defmenu</TT></STRONG>
- : <A HREF="node4.html#1198"><SPAN CLASS="arabic">3</SPAN>.<SPAN CLASS="arabic">4</SPAN>.<SPAN CLASS="arabic">1</SPAN></A>
+ : <A HREF="node4.html#1202"><SPAN CLASS="arabic">3</SPAN>.<SPAN CLASS="arabic">4</SPAN>.<SPAN CLASS="arabic">1</SPAN></A>
 <DD><STRONG>drawing engine</STRONG>
- : <A HREF="node5.html#1906"><SPAN CLASS="arabic">4</SPAN>.<SPAN CLASS="arabic">1</SPAN></A>
+ : <A HREF="node5.html#1910"><SPAN CLASS="arabic">4</SPAN>.<SPAN CLASS="arabic">1</SPAN></A>
 <DD><STRONG><TT>ETCDIR</TT></STRONG>
- : <A HREF="node4.html#583"><SPAN CLASS="arabic">3</SPAN>.<SPAN CLASS="arabic">1</SPAN></A>
+ : <A HREF="node4.html#584"><SPAN CLASS="arabic">3</SPAN>.<SPAN CLASS="arabic">1</SPAN></A>
 <DD><STRONG><TT>float</TT></STRONG>
- : <A HREF="node4.html#1459"><SPAN CLASS="arabic">3</SPAN>.<SPAN CLASS="arabic">5</SPAN></A>
+ : <A HREF="node4.html#1463"><SPAN CLASS="arabic">3</SPAN>.<SPAN CLASS="arabic">5</SPAN></A>
 <DD><STRONG><TT>frame_managed_changed_hook</TT></STRONG>
- : <A HREF="node7.html#8270"><SPAN CLASS="arabic">6</SPAN>.<SPAN CLASS="arabic">9</SPAN></A>
+ : <A HREF="node7.html#8274"><SPAN CLASS="arabic">6</SPAN>.<SPAN CLASS="arabic">9</SPAN></A>
 <DD><STRONG><TT>fullscreen</TT></STRONG>
- : <A HREF="node4.html#1460"><SPAN CLASS="arabic">3</SPAN>.<SPAN CLASS="arabic">5</SPAN></A>
+ : <A HREF="node4.html#1464"><SPAN CLASS="arabic">3</SPAN>.<SPAN CLASS="arabic">5</SPAN></A>
 <DD><STRONG><TT>ignore_resizeinc</TT></STRONG>
- : <A HREF="node4.html#1478"><SPAN CLASS="arabic">3</SPAN>.<SPAN CLASS="arabic">5</SPAN>.<SPAN CLASS="arabic">1</SPAN></A>
- | <A HREF="node4.html#1479"><SPAN CLASS="arabic">3</SPAN>.<SPAN CLASS="arabic">5</SPAN>.<SPAN CLASS="arabic">1</SPAN></A>
+ : <A HREF="node4.html#1482"><SPAN CLASS="arabic">3</SPAN>.<SPAN CLASS="arabic">5</SPAN>.<SPAN CLASS="arabic">1</SPAN></A>
+ | <A HREF="node4.html#1483"><SPAN CLASS="arabic">3</SPAN>.<SPAN CLASS="arabic">5</SPAN>.<SPAN CLASS="arabic">1</SPAN></A>
 <DD><STRONG><TT>ignore_cfgrq</TT></STRONG>
- : <A HREF="node4.html#1461"><SPAN CLASS="arabic">3</SPAN>.<SPAN CLASS="arabic">5</SPAN></A>
+ : <A HREF="node4.html#1465"><SPAN CLASS="arabic">3</SPAN>.<SPAN CLASS="arabic">5</SPAN></A>
 <DD><STRONG><TT>ignore_max_size</TT></STRONG>
- : <A HREF="node4.html#1476"><SPAN CLASS="arabic">3</SPAN>.<SPAN CLASS="arabic">5</SPAN>.<SPAN CLASS="arabic">1</SPAN></A>
+ : <A HREF="node4.html#1480"><SPAN CLASS="arabic">3</SPAN>.<SPAN CLASS="arabic">5</SPAN>.<SPAN CLASS="arabic">1</SPAN></A>
 <DD><STRONG><TT>ignore_min_size</TT></STRONG>
- : <A HREF="node4.html#1477"><SPAN CLASS="arabic">3</SPAN>.<SPAN CLASS="arabic">5</SPAN>.<SPAN CLASS="arabic">1</SPAN></A>
+ : <A HREF="node4.html#1481"><SPAN CLASS="arabic">3</SPAN>.<SPAN CLASS="arabic">5</SPAN>.<SPAN CLASS="arabic">1</SPAN></A>
 <DD><STRONG><TT>ignore_net_active_window</TT></STRONG>
- : <A HREF="node4.html#1462"><SPAN CLASS="arabic">3</SPAN>.<SPAN CLASS="arabic">5</SPAN></A>
+ : <A HREF="node4.html#1466"><SPAN CLASS="arabic">3</SPAN>.<SPAN CLASS="arabic">5</SPAN></A>
 <DD><STRONG><TT>instance</TT></STRONG><DL>
-<DD><STRONG>winprop</STRONG> : <A HREF="node4.html#1483"><SPAN CLASS="arabic">3</SPAN>.<SPAN CLASS="arabic">5</SPAN>.<SPAN CLASS="arabic">2</SPAN></A>
+<DD><STRONG>winprop</STRONG> : <A HREF="node4.html#1487"><SPAN CLASS="arabic">3</SPAN>.<SPAN CLASS="arabic">5</SPAN>.<SPAN CLASS="arabic">2</SPAN></A>
 </DL>
 <DD><STRONG><TT>ioncore_deinit_hook</TT></STRONG>
- : <A HREF="node7.html#8272"><SPAN CLASS="arabic">6</SPAN>.<SPAN CLASS="arabic">9</SPAN></A>
+ : <A HREF="node7.html#8276"><SPAN CLASS="arabic">6</SPAN>.<SPAN CLASS="arabic">9</SPAN></A>
 <DD><STRONG><TT>ioncore_post_layout_setup_hook</TT></STRONG>
- : <A HREF="node7.html#8273"><SPAN CLASS="arabic">6</SPAN>.<SPAN CLASS="arabic">9</SPAN></A>
+ : <A HREF="node7.html#8277"><SPAN CLASS="arabic">6</SPAN>.<SPAN CLASS="arabic">9</SPAN></A>
 <DD><STRONG><TT>ioncore_sigchld_hook</TT></STRONG>
- : <A HREF="node7.html#8271"><SPAN CLASS="arabic">6</SPAN>.<SPAN CLASS="arabic">9</SPAN></A>
+ : <A HREF="node7.html#8275"><SPAN CLASS="arabic">6</SPAN>.<SPAN CLASS="arabic">9</SPAN></A>
 <DD><STRONG><TT>ioncore_snapshot_hook</TT></STRONG>
- : <A HREF="node7.html#8274"><SPAN CLASS="arabic">6</SPAN>.<SPAN CLASS="arabic">9</SPAN></A>
+ : <A HREF="node7.html#8278"><SPAN CLASS="arabic">6</SPAN>.<SPAN CLASS="arabic">9</SPAN></A>
 <DD><STRONG><TT>ioncore_submap_ungrab_hook</TT></STRONG>
- : <A HREF="node7.html#8275"><SPAN CLASS="arabic">6</SPAN>.<SPAN CLASS="arabic">9</SPAN></A>
+ : <A HREF="node7.html#8279"><SPAN CLASS="arabic">6</SPAN>.<SPAN CLASS="arabic">9</SPAN></A>
 <DD><STRONG><TT>is_dockapp</TT></STRONG><DL>
-<DD><STRONG>winprop</STRONG> : <A HREF="node4.html#1486"><SPAN CLASS="arabic">3</SPAN>.<SPAN CLASS="arabic">5</SPAN>.<SPAN CLASS="arabic">2</SPAN></A>
+<DD><STRONG>winprop</STRONG> : <A HREF="node4.html#1490"><SPAN CLASS="arabic">3</SPAN>.<SPAN CLASS="arabic">5</SPAN>.<SPAN CLASS="arabic">2</SPAN></A>
 </DL>
 <DD><STRONG><TT>is_transient</TT></STRONG><DL>
-<DD><STRONG>winprop</STRONG> : <A HREF="node4.html#1485"><SPAN CLASS="arabic">3</SPAN>.<SPAN CLASS="arabic">5</SPAN>.<SPAN CLASS="arabic">2</SPAN></A>
+<DD><STRONG>winprop</STRONG> : <A HREF="node4.html#1489"><SPAN CLASS="arabic">3</SPAN>.<SPAN CLASS="arabic">5</SPAN>.<SPAN CLASS="arabic">2</SPAN></A>
 </DL>
 <DD><STRONG><TT>jumpto</TT></STRONG>
- : <A HREF="node4.html#1463"><SPAN CLASS="arabic">3</SPAN>.<SPAN CLASS="arabic">5</SPAN></A>
+ : <A HREF="node4.html#1467"><SPAN CLASS="arabic">3</SPAN>.<SPAN CLASS="arabic">5</SPAN></A>
 <DD><STRONG><SPAN  CLASS="textit">keysymdef.h</SPAN></STRONG>
- : <A HREF="node4.html#877"><SPAN CLASS="arabic">3</SPAN>.<SPAN CLASS="arabic">3</SPAN>.<SPAN CLASS="arabic">5</SPAN></A>
+ : <A HREF="node4.html#881"><SPAN CLASS="arabic">3</SPAN>.<SPAN CLASS="arabic">3</SPAN>.<SPAN CLASS="arabic">5</SPAN></A>
 <DD><STRONG><SPAN  CLASS="textbf">Lock</SPAN></STRONG>
- : <A HREF="node4.html#882"><SPAN CLASS="arabic">3</SPAN>.<SPAN CLASS="arabic">3</SPAN>.<SPAN CLASS="arabic">5</SPAN></A>
+ : <A HREF="node4.html#886"><SPAN CLASS="arabic">3</SPAN>.<SPAN CLASS="arabic">3</SPAN>.<SPAN CLASS="arabic">5</SPAN></A>
 <DD><STRONG>manager</STRONG>
  : <A HREF="node3.html#382"><SPAN CLASS="arabic">2</SPAN>.<SPAN CLASS="arabic">2</SPAN>.<SPAN CLASS="arabic">2</SPAN>.<SPAN CLASS="arabic">1</SPAN></A>
 <DD><STRONG><TT>max_size</TT></STRONG>
- : <A HREF="node4.html#1472"><SPAN CLASS="arabic">3</SPAN>.<SPAN CLASS="arabic">5</SPAN>.<SPAN CLASS="arabic">1</SPAN></A>
+ : <A HREF="node4.html#1476"><SPAN CLASS="arabic">3</SPAN>.<SPAN CLASS="arabic">5</SPAN>.<SPAN CLASS="arabic">1</SPAN></A>
 <DD><STRONG><TT>menuentry</TT></STRONG>
- : <A HREF="node4.html#1199"><SPAN CLASS="arabic">3</SPAN>.<SPAN CLASS="arabic">4</SPAN>.<SPAN CLASS="arabic">1</SPAN></A>
+ : <A HREF="node4.html#1203"><SPAN CLASS="arabic">3</SPAN>.<SPAN CLASS="arabic">4</SPAN>.<SPAN CLASS="arabic">1</SPAN></A>
 <DD><STRONG>menus</STRONG>
- : <A HREF="node4.html#1144"><SPAN CLASS="arabic">3</SPAN>.<SPAN CLASS="arabic">4</SPAN>.<SPAN CLASS="arabic">1</SPAN></A>
+ : <A HREF="node4.html#1148"><SPAN CLASS="arabic">3</SPAN>.<SPAN CLASS="arabic">4</SPAN>.<SPAN CLASS="arabic">1</SPAN></A>
 <DD><STRONG><TT>min_size</TT></STRONG>
- : <A HREF="node4.html#1473"><SPAN CLASS="arabic">3</SPAN>.<SPAN CLASS="arabic">5</SPAN>.<SPAN CLASS="arabic">1</SPAN></A>
+ : <A HREF="node4.html#1477"><SPAN CLASS="arabic">3</SPAN>.<SPAN CLASS="arabic">5</SPAN>.<SPAN CLASS="arabic">1</SPAN></A>
 <DD><STRONG><SPAN  CLASS="textbf">ModN</SPAN></STRONG>
- : <A HREF="node4.html#880"><SPAN CLASS="arabic">3</SPAN>.<SPAN CLASS="arabic">3</SPAN>.<SPAN CLASS="arabic">5</SPAN></A>
+ : <A HREF="node4.html#884"><SPAN CLASS="arabic">3</SPAN>.<SPAN CLASS="arabic">3</SPAN>.<SPAN CLASS="arabic">5</SPAN></A>
 <DD><STRONG><TT>name</TT></STRONG><DL>
-<DD><STRONG>winprop</STRONG> : <A HREF="node4.html#1484"><SPAN CLASS="arabic">3</SPAN>.<SPAN CLASS="arabic">5</SPAN>.<SPAN CLASS="arabic">2</SPAN></A>
+<DD><STRONG>winprop</STRONG> : <A HREF="node4.html#1488"><SPAN CLASS="arabic">3</SPAN>.<SPAN CLASS="arabic">5</SPAN>.<SPAN CLASS="arabic">2</SPAN></A>
 </DL>
 <DD><STRONG><TT>new_group</TT></STRONG>
- : <A HREF="node4.html#1464"><SPAN CLASS="arabic">3</SPAN>.<SPAN CLASS="arabic">5</SPAN></A>
+ : <A HREF="node4.html#1468"><SPAN CLASS="arabic">3</SPAN>.<SPAN CLASS="arabic">5</SPAN></A>
 <DD><STRONG><SPAN  CLASS="textbf">NumLock</SPAN></STRONG>
- : <A HREF="node4.html#885"><SPAN CLASS="arabic">3</SPAN>.<SPAN CLASS="arabic">3</SPAN>.<SPAN CLASS="arabic">5</SPAN></A>
+ : <A HREF="node4.html#889"><SPAN CLASS="arabic">3</SPAN>.<SPAN CLASS="arabic">3</SPAN>.<SPAN CLASS="arabic">5</SPAN></A>
 <DD><STRONG>Obj</STRONG>
  : <A HREF="node3.html#410"><SPAN CLASS="arabic">2</SPAN>.<SPAN CLASS="arabic">2</SPAN>.<SPAN CLASS="arabic">1</SPAN></A>
 <DD><STRONG><TT>oneshot</TT></STRONG>
- : <A HREF="node4.html#1465"><SPAN CLASS="arabic">3</SPAN>.<SPAN CLASS="arabic">5</SPAN></A>
+ : <A HREF="node4.html#1469"><SPAN CLASS="arabic">3</SPAN>.<SPAN CLASS="arabic">5</SPAN></A>
 <DD><STRONG><TT>orientation</TT></STRONG>
- : <A HREF="node4.html#1466"><SPAN CLASS="arabic">3</SPAN>.<SPAN CLASS="arabic">5</SPAN></A>
+ : <A HREF="node4.html#1470"><SPAN CLASS="arabic">3</SPAN>.<SPAN CLASS="arabic">5</SPAN></A>
 <DD><STRONG>parent</STRONG>
  : <A HREF="node3.html#367"><SPAN CLASS="arabic">2</SPAN>.<SPAN CLASS="arabic">2</SPAN>.<SPAN CLASS="arabic">2</SPAN>.<SPAN CLASS="arabic">1</SPAN></A>
 <DD><STRONG><TT>PREFIX</TT></STRONG>
- : <A HREF="node4.html#582"><SPAN CLASS="arabic">3</SPAN>.<SPAN CLASS="arabic">1</SPAN></A>
+ : <A HREF="node4.html#583"><SPAN CLASS="arabic">3</SPAN>.<SPAN CLASS="arabic">1</SPAN></A>
 <DD><STRONG><TT>region_do_warp_alt</TT></STRONG>
- : <A HREF="node7.html#8277"><SPAN CLASS="arabic">6</SPAN>.<SPAN CLASS="arabic">9</SPAN></A>
+ : <A HREF="node7.html#8281"><SPAN CLASS="arabic">6</SPAN>.<SPAN CLASS="arabic">9</SPAN></A>
 <DD><STRONG><TT>region_notify_hook</TT></STRONG>
- : <A HREF="node7.html#8279"><SPAN CLASS="arabic">6</SPAN>.<SPAN CLASS="arabic">9</SPAN></A>
+ : <A HREF="node7.html#8283"><SPAN CLASS="arabic">6</SPAN>.<SPAN CLASS="arabic">9</SPAN></A>
 <DD><STRONG><TT>role</TT></STRONG><DL>
-<DD><STRONG>winprop</STRONG> : <A HREF="node4.html#1482"><SPAN CLASS="arabic">3</SPAN>.<SPAN CLASS="arabic">5</SPAN>.<SPAN CLASS="arabic">2</SPAN></A>
+<DD><STRONG>winprop</STRONG> : <A HREF="node4.html#1486"><SPAN CLASS="arabic">3</SPAN>.<SPAN CLASS="arabic">5</SPAN>.<SPAN CLASS="arabic">2</SPAN></A>
 </DL>
 <DD><STRONG>root window</STRONG>
  : <A HREF="node3.html#331"><SPAN CLASS="arabic">2</SPAN>.<SPAN CLASS="arabic">2</SPAN>.<SPAN CLASS="arabic">1</SPAN></A>
@@ -172,35 +172,35 @@ Index</A>
 <DD><STRONG>X</STRONG> : <A HREF="node3.html#332"><SPAN CLASS="arabic">2</SPAN>.<SPAN CLASS="arabic">2</SPAN>.<SPAN CLASS="arabic">1</SPAN></A>
 </DL>
 <DD><STRONG><TT>screen_managed_changed_hook</TT></STRONG>
- : <A HREF="node7.html#8278"><SPAN CLASS="arabic">6</SPAN>.<SPAN CLASS="arabic">9</SPAN></A>
+ : <A HREF="node7.html#8282"><SPAN CLASS="arabic">6</SPAN>.<SPAN CLASS="arabic">9</SPAN></A>
 <DD><STRONG><SPAN  CLASS="textbf">ScrollLock</SPAN></STRONG>
- : <A HREF="node4.html#886"><SPAN CLASS="arabic">3</SPAN>.<SPAN CLASS="arabic">3</SPAN>.<SPAN CLASS="arabic">5</SPAN></A>
+ : <A HREF="node4.html#890"><SPAN CLASS="arabic">3</SPAN>.<SPAN CLASS="arabic">3</SPAN>.<SPAN CLASS="arabic">5</SPAN></A>
 <DD><STRONG><SPAN  CLASS="textbf">Shift</SPAN></STRONG>
- : <A HREF="node4.html#878"><SPAN CLASS="arabic">3</SPAN>.<SPAN CLASS="arabic">3</SPAN>.<SPAN CLASS="arabic">5</SPAN></A>
+ : <A HREF="node4.html#882"><SPAN CLASS="arabic">3</SPAN>.<SPAN CLASS="arabic">3</SPAN>.<SPAN CLASS="arabic">5</SPAN></A>
 <DD><STRONG><TT>statusbar</TT></STRONG>
- : <A HREF="node4.html#1467"><SPAN CLASS="arabic">3</SPAN>.<SPAN CLASS="arabic">5</SPAN></A>
+ : <A HREF="node4.html#1471"><SPAN CLASS="arabic">3</SPAN>.<SPAN CLASS="arabic">5</SPAN></A>
 <DD><STRONG>style</STRONG>
- : <A HREF="node5.html#1905"><SPAN CLASS="arabic">4</SPAN>.<SPAN CLASS="arabic">1</SPAN></A>
+ : <A HREF="node5.html#1909"><SPAN CLASS="arabic">4</SPAN>.<SPAN CLASS="arabic">1</SPAN></A>
 <DD><STRONG><TT>submenu</TT></STRONG>
- : <A HREF="node4.html#1200"><SPAN CLASS="arabic">3</SPAN>.<SPAN CLASS="arabic">4</SPAN>.<SPAN CLASS="arabic">1</SPAN></A>
+ : <A HREF="node4.html#1204"><SPAN CLASS="arabic">3</SPAN>.<SPAN CLASS="arabic">4</SPAN>.<SPAN CLASS="arabic">1</SPAN></A>
 <DD><STRONG>substyle</STRONG>
- : <A HREF="node5.html#1918"><SPAN CLASS="arabic">4</SPAN>.<SPAN CLASS="arabic">1</SPAN></A>
+ : <A HREF="node5.html#1922"><SPAN CLASS="arabic">4</SPAN>.<SPAN CLASS="arabic">1</SPAN></A>
 <DD><STRONG><TT>switchto</TT></STRONG>
- : <A HREF="node4.html#1468"><SPAN CLASS="arabic">3</SPAN>.<SPAN CLASS="arabic">5</SPAN></A>
+ : <A HREF="node4.html#1472"><SPAN CLASS="arabic">3</SPAN>.<SPAN CLASS="arabic">5</SPAN></A>
 <DD><STRONG><SPAN  CLASS="textit">system.mk</SPAN></STRONG>
- : <A HREF="node4.html#584"><SPAN CLASS="arabic">3</SPAN>.<SPAN CLASS="arabic">1</SPAN></A>
+ : <A HREF="node4.html#585"><SPAN CLASS="arabic">3</SPAN>.<SPAN CLASS="arabic">1</SPAN></A>
 <DD><STRONG><TT>target</TT></STRONG>
- : <A HREF="node4.html#1469"><SPAN CLASS="arabic">3</SPAN>.<SPAN CLASS="arabic">5</SPAN></A>
+ : <A HREF="node4.html#1473"><SPAN CLASS="arabic">3</SPAN>.<SPAN CLASS="arabic">5</SPAN></A>
 <DD><STRONG><TT>tiling_placement_alt</TT></STRONG>
- : <A HREF="node7.html#8276"><SPAN CLASS="arabic">6</SPAN>.<SPAN CLASS="arabic">9</SPAN></A>
+ : <A HREF="node7.html#8280"><SPAN CLASS="arabic">6</SPAN>.<SPAN CLASS="arabic">9</SPAN></A>
 <DD><STRONG>transient</STRONG>
- : <A HREF="node4.html#1439"><SPAN CLASS="arabic">3</SPAN>.<SPAN CLASS="arabic">5</SPAN>.<SPAN CLASS="arabic">3</SPAN></A>
+ : <A HREF="node4.html#1443"><SPAN CLASS="arabic">3</SPAN>.<SPAN CLASS="arabic">5</SPAN>.<SPAN CLASS="arabic">3</SPAN></A>
 <DD><STRONG><TT>transient_mode</TT></STRONG>
- : <A HREF="node4.html#1470"><SPAN CLASS="arabic">3</SPAN>.<SPAN CLASS="arabic">5</SPAN></A>
+ : <A HREF="node4.html#1474"><SPAN CLASS="arabic">3</SPAN>.<SPAN CLASS="arabic">5</SPAN></A>
 <DD><STRONG><TT>transparent</TT></STRONG>
- : <A HREF="node4.html#1471"><SPAN CLASS="arabic">3</SPAN>.<SPAN CLASS="arabic">5</SPAN></A>
+ : <A HREF="node4.html#1475"><SPAN CLASS="arabic">3</SPAN>.<SPAN CLASS="arabic">5</SPAN></A>
 <DD><STRONG><TT>userpos</TT></STRONG>
- : <A HREF="node4.html#1480"><SPAN CLASS="arabic">3</SPAN>.<SPAN CLASS="arabic">5</SPAN>.<SPAN CLASS="arabic">1</SPAN></A>
+ : <A HREF="node4.html#1484"><SPAN CLASS="arabic">3</SPAN>.<SPAN CLASS="arabic">5</SPAN>.<SPAN CLASS="arabic">1</SPAN></A>
 <DD><STRONG>WClientWin</STRONG>
  : <A HREF="node3.html#412"><SPAN CLASS="arabic">2</SPAN>.<SPAN CLASS="arabic">2</SPAN>.<SPAN CLASS="arabic">1</SPAN></A>
 <DD><STRONG>WEdln</STRONG>
@@ -214,7 +214,7 @@ Index</A>
 <DD><STRONG>WGroupWS</STRONG>
  : <A HREF="node3.html#418"><SPAN CLASS="arabic">2</SPAN>.<SPAN CLASS="arabic">2</SPAN>.<SPAN CLASS="arabic">1</SPAN></A>
 <DD><STRONG>Winprops</STRONG>
- : <A HREF="node4.html#1291"><SPAN CLASS="arabic">3</SPAN>.<SPAN CLASS="arabic">5</SPAN></A>
+ : <A HREF="node4.html#1295"><SPAN CLASS="arabic">3</SPAN>.<SPAN CLASS="arabic">5</SPAN></A>
 <DD><STRONG>WInput</STRONG>
  : <A HREF="node3.html#424"><SPAN CLASS="arabic">2</SPAN>.<SPAN CLASS="arabic">2</SPAN>.<SPAN CLASS="arabic">1</SPAN></A>
 <DD><STRONG>WMessage</STRONG>
@@ -234,9 +234,9 @@ Index</A>
 <DD><STRONG>Xinerama</STRONG>
  : <A HREF="node3.html#335"><SPAN CLASS="arabic">2</SPAN>.<SPAN CLASS="arabic">2</SPAN>.<SPAN CLASS="arabic">1</SPAN></A>
 <DD><STRONG><SPAN  CLASS="textit">xmodmap</SPAN></STRONG>
- : <A HREF="node4.html#884"><SPAN CLASS="arabic">3</SPAN>.<SPAN CLASS="arabic">3</SPAN>.<SPAN CLASS="arabic">5</SPAN></A>
+ : <A HREF="node4.html#888"><SPAN CLASS="arabic">3</SPAN>.<SPAN CLASS="arabic">3</SPAN>.<SPAN CLASS="arabic">5</SPAN></A>
 <DD><STRONG>xprop</STRONG>
- : <A HREF="node4.html#1435"><SPAN CLASS="arabic">3</SPAN>.<SPAN CLASS="arabic">5</SPAN>.<SPAN CLASS="arabic">3</SPAN></A>
+ : <A HREF="node4.html#1439"><SPAN CLASS="arabic">3</SPAN>.<SPAN CLASS="arabic">5</SPAN>.<SPAN CLASS="arabic">3</SPAN></A>
 
 </DL>
 
index f12c7f43d924ba5a037095eac00061a34ae2c890..907b1b9a5211d9bf3e7cd187ff67a0ffa1dc37c4 100644 (file)
@@ -70,7 +70,7 @@ Mathematics Department, Macquarie University, Sydney.
 The command line arguments were: <BR>
  <STRONG>latex2html</STRONG> <TT>-show_section_numbers -short_index -local_icons -noaddress -up_url http://iki.fi/tuomov/ion/ -up_title 'Ion homepage' -nofootnode -split 3 ionconf</TT>
 <P>
-The translation was initiated by tuomov on 2007-09-02
+The translation was initiated by tuomov on 2007-09-27
 <BR><HR>
 
 </BODY>
index f041fdff8e43d782bf30cf5ae234d050df30af6f..3980bc4e3ca85283da27a51afb3a2a4931da043b 100644 (file)
@@ -153,7 +153,7 @@ before continuing with this chapter.
 Section <A HREF="#sec:conffiles">3.1</A>&nbsp;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 <SPAN  CLASS="textit">ion.lua</SPAN> is provided in section 
+configuration file <SPAN  CLASS="textit">cfg_ion.lua</SPAN> is provided in section 
 <A HREF="#sec:walkthrough">3.2</A>.
 How keys and mouse action are bound to functions is described in detail
 in <A HREF="#sec:bindings">3.3</A> and in section <A HREF="#sec:winprops">3.5</A> winprops are
@@ -172,9 +172,9 @@ For a reference on exported functions, see section <A HREF="node7.html#sec:expor
 Ion3, to which document applies, stores its stock configuration files in
 <SPAN  CLASS="textit">/usr/local/etc/ion3/</SPAN> unless you, the OS package maintainer or 
 whoever  installed the package on the system has modified the variables
-<TT>PREFIX</TT><A NAME="582"></A> or
-<TT>ETCDIR</TT><A NAME="583"></A> in
-<SPAN  CLASS="textit">system.mk</SPAN><A NAME="584"></A> before compiling Ion.
+<TT>PREFIX</TT><A NAME="583"></A> or
+<TT>ETCDIR</TT><A NAME="584"></A> in
+<SPAN  CLASS="textit">system.mk</SPAN><A NAME="585"></A> before compiling Ion.
 In the first case you probably know where to find the files and in 
 the other case the system administrator or the OS package maintainer
 should  have provided documentation to point to the correct location. 
@@ -189,15 +189,22 @@ 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 <SPAN  CLASS="textit">~/.ion3/</SPAN> and modify this file. When searching
-for a file, if no extension or path component is given, compiled <SPAN  CLASS="textit">.lc</SPAN> 
-files are attempted before <SPAN  CLASS="textit">.lua</SPAN> files.
+file in <SPAN  CLASS="textit">~/.ion3/</SPAN> 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 <SPAN  CLASS="textit">cfg_ion.lua</SPAN>.
 
 <P>
 All the configuration files are named <SPAN  CLASS="textit">cfg_*.lua</SPAN> with the ``<SPAN  CLASS="textit">*</SPAN>''
 part varying. The configuration file for each module <SPAN  CLASS="textit">mod_modname</SPAN> is
 <SPAN  CLASS="textit">cfg_modname.lua</SPAN>, with <SPAN  CLASS="textit">modname</SPAN> varying by the module in
-question. The following table summarises these and other configuration
+question. Configuration files can also be compiled into <SPAN  CLASS="textit">.lc</SPAN> files,
+and these are attempted by the configuration file search routines before
+<SPAN  CLASS="textit">.lua</SPAN> files.
+
+<P>
+The following table summarises these and other configuration
 files:
 
 <P>
@@ -612,8 +619,8 @@ defbindings("WFrame", {
 As seen above, the functions that create key binding specifications require
 a <TT>keyspec</TT> argument. This argument should be a string containing the
 name of a key as listed in the X header file <SPAN  CLASS="textit">keysymdef.h</SPAN><A NAME="tex2html7"
-  HREF="#foot876"><SUP><SPAN CLASS="arabic">3</SPAN>.<SPAN CLASS="arabic">1</SPAN></SUP></A> without the <TT>XK_</TT> prefix.
-<A NAME="877"></A>
+  HREF="#foot880"><SUP><SPAN CLASS="arabic">3</SPAN>.<SPAN CLASS="arabic">1</SPAN></SUP></A> without the <TT>XK_</TT> prefix.
+<A NAME="881"></A>
 Most of the key names are quite intuitive while some are not. For example,
 the <SPAN  CLASS="textbf">Enter</SPAN> key on the main part of the keyboard has the less common
 name <SPAN  CLASS="textbf">Return</SPAN> while the one the numpad is called <SPAN  CLASS="textbf">KP_Enter</SPAN>.
@@ -626,21 +633,21 @@ modifiers:
 <P>
 <SPAN  CLASS="textbf">Shift</SPAN>, <SPAN  CLASS="textbf">Control</SPAN>, <SPAN  CLASS="textbf">Mod1</SPAN> to <SPAN  CLASS="textbf">Mod5</SPAN>,
 <SPAN  CLASS="textbf">AnyModifier</SPAN> and <SPAN  CLASS="textbf">Lock</SPAN>.
-<A NAME="878"></A>
-<A NAME="879"></A>
-<A NAME="880"></A>
-<A NAME="881"></A>
 <A NAME="882"></A>
+<A NAME="883"></A>
+<A NAME="884"></A>
+<A NAME="885"></A>
+<A NAME="886"></A>
 
 <P>
 X allows binding all of these modifiers to almost any key and while this
 list of modifiers does not explicitly list keys such as 
-<SPAN  CLASS="textbf">Alt</SPAN><A NAME="883"></A> that are common on modern keyboards, such
+<SPAN  CLASS="textbf">Alt</SPAN><A NAME="887"></A> that are common on modern keyboards, such
 keys are bound to one of the <SPAN  CLASS="textbf">ModN</SPAN>. On systems running XFree86
 <SPAN  CLASS="textbf">Alt</SPAN> is usually <SPAN  CLASS="textbf">Mod1</SPAN>. On Suns <SPAN  CLASS="textbf">Mod1</SPAN> is the diamond key
 and <SPAN  CLASS="textbf">Alt</SPAN> something else. One of the ``flying window'' keys on so
 called Windows-keyboards is probably mapped to <SPAN  CLASS="textbf">Mod3</SPAN> if you have
-such a key. Use the program <SPAN  CLASS="textit">xmodmap</SPAN><A NAME="884"></A>
+such a key. Use the program <SPAN  CLASS="textit">xmodmap</SPAN><A NAME="888"></A>
 to find out what exactly is bound where. 
 
 <P>
@@ -655,10 +662,10 @@ Ion ignores the <SPAN  CLASS="textbf">Lock</SPAN> modifier and any <SPAN  CLASS=
  WIDTH="82" HEIGHT="15" ALIGN="BOTTOM" BORDER="0"
  SRC="img2.png"
  ALT="$N=1{\ldots} 5$"></SPAN>)
-bound to <SPAN  CLASS="textbf">NumLock</SPAN><A NAME="885"></A> or
-<SPAN  CLASS="textbf">ScrollLock</SPAN><A NAME="886"></A>
+bound to <SPAN  CLASS="textbf">NumLock</SPAN><A NAME="889"></A> or
+<SPAN  CLASS="textbf">ScrollLock</SPAN><A NAME="890"></A>
 by default because such<A NAME="tex2html8"
-  HREF="#foot855"><SUP><SPAN CLASS="arabic">3</SPAN>.<SPAN CLASS="arabic">2</SPAN></SUP></A> locking keys may otherwise
+  HREF="#foot859"><SUP><SPAN CLASS="arabic">3</SPAN>.<SPAN CLASS="arabic">2</SPAN></SUP></A> locking keys may otherwise
 cause confusion.
 
 <P>
@@ -671,7 +678,7 @@ cause confusion.
 Button specifications are similar to key definitions but now
 instead of specifying modifiers and a key, you specify modifiers
 and one of the button names <SPAN  CLASS="textbf">Button1</SPAN> to
-<SPAN  CLASS="textbf">Button5</SPAN><A NAME="887"></A>. Additionally the
+<SPAN  CLASS="textbf">Button5</SPAN><A NAME="891"></A>. Additionally the
 specification may end with an optional area name following an @-sign.
 Only frames currently support areas, and the supported values in this
 case are
@@ -722,10 +729,10 @@ to it is available virtually everywhere.
 </H3>
 
 <P>
-<A NAME="1144"></A>
-<A NAME="1198"></A>
-<A NAME="1199"></A>
-<A NAME="1200"></A>
+<A NAME="1148"></A>
+<A NAME="1202"></A>
+<A NAME="1203"></A>
+<A NAME="1204"></A>
 In the stock configuration file setup, menus are defined in the file
 <SPAN  CLASS="textit">cfg_menus.lua</SPAN> as previously mentioned. The <SPAN  CLASS="textit">mod_menu</SPAN> module
 must be loaded for one to be able to define menus, and this is done with
@@ -887,7 +894,7 @@ defbindings("WFrame", {
 </H2>
 
 <P>
-The so-called ``winprops''<A NAME="1291"></A> can be used to change how
+The so-called ``winprops''<A NAME="1295"></A> can be used to change how
 specific windows are handled and to set up some kludges to deal with
 badly behaving applications. They are defined by calling the function
 <TT>defwinprop</TT> with a table containing the properties to set and the
@@ -905,7 +912,7 @@ usual method of identifying windows, and how to obtain this information.
       
 </DD>
 <DT><STRONG>Description:</STRONG></DT>
-<DD><A NAME="1458"></A>
+<DD><A NAME="1462"></A>
     Set this to <TT>true</TT> for Acrobat Reader. It has an annoying
     habit of trying to manage its dialogs instead of setting them as
     transients and letting the window manager do its job, causing
@@ -923,7 +930,7 @@ usual method of identifying windows, and how to obtain this information.
       
 </DD>
 <DT><STRONG>Description:</STRONG></DT>
-<DD><A NAME="1459"></A>
+<DD><A NAME="1463"></A>
     Set this to open the window in a floating frame, when
     in a group.
 
@@ -938,7 +945,7 @@ usual method of identifying windows, and how to obtain this information.
       
 </DD>
 <DT><STRONG>Description:</STRONG></DT>
-<DD><A NAME="1460"></A>
+<DD><A NAME="1464"></A>
     Should the window be initially in full screen mode?
 
 </DD>
@@ -952,7 +959,7 @@ usual method of identifying windows, and how to obtain this information.
       
 </DD>
 <DT><STRONG>Description:</STRONG></DT>
-<DD><A NAME="1461"></A>
+<DD><A NAME="1465"></A>
     Should configure requests on the window be ignored?
     Only has effect on floating windows.
 
@@ -967,7 +974,7 @@ usual method of identifying windows, and how to obtain this information.
       
 </DD>
 <DT><STRONG>Description:</STRONG></DT>
-<DD><A NAME="1462"></A>
+<DD><A NAME="1466"></A>
     Ignore extended WM hints <TT>_NET_ACTIVE_WINDOW</TT> request.
 
 </DD>
@@ -981,7 +988,7 @@ usual method of identifying windows, and how to obtain this information.
       
 </DD>
 <DT><STRONG>Description:</STRONG></DT>
-<DD><A NAME="1463"></A>
+<DD><A NAME="1467"></A>
     Should a newly created client window always be made
     active, even if the allocated frame isn't.
 
@@ -996,7 +1003,7 @@ usual method of identifying windows, and how to obtain this information.
       
 </DD>
 <DT><STRONG>Description:</STRONG></DT>
-<DD><A NAME="1464"></A>
+<DD><A NAME="1468"></A>
     If the region specified by <TT>target</TT> winprop does not exist
     (or that winprop is not set), create a new workspace using the 
     previously stored layout (see <A HREF="node7.html#fn:ioncore.deflayout"><TT>ioncore.deflayout</TT></A>) named by
@@ -1015,7 +1022,7 @@ usual method of identifying windows, and how to obtain this information.
       
 </DD>
 <DT><STRONG>Description:</STRONG></DT>
-<DD><A NAME="1465"></A>
+<DD><A NAME="1469"></A>
     Discard this winprop after first use.
 
 </DD>
@@ -1029,7 +1036,7 @@ usual method of identifying windows, and how to obtain this information.
       
 </DD>
 <DT><STRONG>Description:</STRONG></DT>
-<DD><A NAME="1466"></A>
+<DD><A NAME="1470"></A>
     The orientation of the window: one of `<TT>vertical</TT>' or
     `<TT>horizontal</TT>'. This is only useful when using the
     window as a status display.
@@ -1045,7 +1052,7 @@ usual method of identifying windows, and how to obtain this information.
       
 </DD>
 <DT><STRONG>Description:</STRONG></DT>
-<DD><A NAME="1467"></A>
+<DD><A NAME="1471"></A>
     Put the window in the statusbar, in the named tray component,
     (The default tray component is called simply `<TT>systray</TT>', 
     and others you give names to in your custom template, always 
@@ -1062,7 +1069,7 @@ usual method of identifying windows, and how to obtain this information.
       
 </DD>
 <DT><STRONG>Description:</STRONG></DT>
-<DD><A NAME="1468"></A>
+<DD><A NAME="1472"></A>
     Should a newly mapped client window be switched to within
     its frame.
 
@@ -1077,7 +1084,7 @@ usual method of identifying windows, and how to obtain this information.
       
 </DD>
 <DT><STRONG>Description:</STRONG></DT>
-<DD><A NAME="1469"></A>
+<DD><A NAME="1473"></A>
     The name of an object (workspace, frame) that should manage 
     windows of this type. See also <TT>new_group</TT>.
 
@@ -1092,7 +1099,7 @@ usual method of identifying windows, and how to obtain this information.
       
 </DD>
 <DT><STRONG>Description:</STRONG></DT>
-<DD><A NAME="1470"></A>
+<DD><A NAME="1474"></A>
     `<TT>normal</TT>': No change in behaviour. `<TT>current</TT>':
     The window should be thought of as a transient for the current
     active client window (if any) even if it is not marked as a
@@ -1111,7 +1118,7 @@ usual method of identifying windows, and how to obtain this information.
       
 </DD>
 <DT><STRONG>Description:</STRONG></DT>
-<DD><A NAME="1471"></A>
+<DD><A NAME="1475"></A>
     Should frames be made transparent when this window is selected? 
 <BR>  
   
@@ -1126,15 +1133,15 @@ usual method of identifying windows, and how to obtain this information.
 
 <P>
 Additionally, the winprops 
-<TT>max_size</TT><A NAME="1472"></A>,
-<TT>min_size</TT><A NAME="1473"></A>,
-<TT>aspect</TT><A NAME="1474"></A>,
-<TT>resizeinc</TT><A NAME="1475"></A>,
+<TT>max_size</TT><A NAME="1476"></A>,
+<TT>min_size</TT><A NAME="1477"></A>,
+<TT>aspect</TT><A NAME="1478"></A>,
+<TT>resizeinc</TT><A NAME="1479"></A>,
 and
-<TT>ignore_max_size</TT><A NAME="1476"></A>,
-<TT>ignore_min_size</TT><A NAME="1477"></A>,
-<TT>ignore_aspect</TT><A NAME="1478"></A>,
-<TT>ignore_resizeinc</TT><A NAME="1479"></A>,
+<TT>ignore_max_size</TT><A NAME="1480"></A>,
+<TT>ignore_min_size</TT><A NAME="1481"></A>,
+<TT>ignore_aspect</TT><A NAME="1482"></A>,
+<TT>ignore_resizeinc</TT><A NAME="1483"></A>,
 may be used to override application-supplied size hints. The four
 first ones are tables with the fields <TT>w</TT> and <TT>h</TT>, indicating
 the width and height size hints in pixels, and the latter ignore
@@ -1142,7 +1149,7 @@ winprop is a boolean.
 
 <P>
 Finally, the boolean
-<TT>userpos</TT><A NAME="1480"></A> option may be used to
+<TT>userpos</TT><A NAME="1484"></A> option may be used to
 override the <TT>USPosition</TT> flag of the size hints. Normally,
 when this flag is set, Ion tries to respect the supplied window
 position more than when it is not set. Obviously, this makes sense
@@ -1158,12 +1165,12 @@ only for floating windows.
 
 <P>
 The identification information supported are
-<TT>class</TT><A NAME="1481"></A>,
-<TT>role</TT><A NAME="1482"></A>,
-<TT>instance</TT><A NAME="1483"></A>,
-<TT>name</TT><A NAME="1484"></A>,
-<TT>is_transient</TT><A NAME="1485"></A>, and
-<TT>is_dockapp</TT><A NAME="1486"></A>.
+<TT>class</TT><A NAME="1485"></A>,
+<TT>role</TT><A NAME="1486"></A>,
+<TT>instance</TT><A NAME="1487"></A>,
+<TT>name</TT><A NAME="1488"></A>,
+<TT>is_transient</TT><A NAME="1489"></A>, and
+<TT>is_dockapp</TT><A NAME="1490"></A>.
 It is not necessary to specify all of these fields.
 The first three are strings, and must exactly match the
 corresponding information obtained from the window's properties.
@@ -1251,7 +1258,7 @@ can be used to list the identification information required to set winprops
 for a window and all the transient windows managed within it. 
 
 <P>
-<A NAME="1435"></A> 
+<A NAME="1439"></A> 
 Another way to get the identification information is to use <TT>xprop</TT>.
 Simply run To get class and instance, simply run <TT>xprop WM_CLASS</TT>
 and click on the particular window of interest. The class is the latter of
@@ -1260,7 +1267,7 @@ windows have this property - use the command <TT>xprop WM_ROLE</TT>.
 This method, however, will not work on transients. 
 
 <P>
-<A NAME="1439"></A>
+<A NAME="1443"></A>
 So-called ``transient windows'' are usually short-lived dialogs (although
 some programs abuse this property) that have a parent window that they are
 ``transient for''. On tiled workspaces Ion displays these windows 
@@ -1269,7 +1276,7 @@ Unfortunately <TT>xprop</TT> is stupid and can't cope with this situation,
 returning the parent window's properties when the transient is clicked on.
 For this reason you'll have to do a little extra work to get the properties
 for that window.<A NAME="tex2html9"
-  HREF="#foot1488"><SUP><SPAN CLASS="arabic">3</SPAN>.<SPAN CLASS="arabic">3</SPAN></SUP></A>
+  HREF="#foot1492"><SUP><SPAN CLASS="arabic">3</SPAN>.<SPAN CLASS="arabic">3</SPAN></SUP></A>
 <P>
 Finally, it should be mentioned that too many authors these days
 ``forget'' to set this vital identification to anything meaningful:
@@ -1507,19 +1514,19 @@ for the additional mailboxes (`<TT>*</TT>' varying).
 <P>
 <BR><HR><H4>Footnotes</H4>
 <DL>
-<DT><A NAME="foot876">...keysymdef.h</A><A
+<DT><A NAME="foot880">...keysymdef.h</A><A
  HREF="node4.html#tex2html7"><SUP><SPAN CLASS="arabic">3</SPAN>.<SPAN CLASS="arabic">1</SPAN></SUP></A></DT>
 <DD>This file can usually be found in the directory
 <SPAN  CLASS="textit">/usr/X11R6/include/X11/</SPAN>.
 
 </DD>
-<DT><A NAME="foot855">... such</A><A
+<DT><A NAME="foot859">... such</A><A
  HREF="node4.html#tex2html8"><SUP><SPAN CLASS="arabic">3</SPAN>.<SPAN CLASS="arabic">2</SPAN></SUP></A></DT>
 <DD>Completely useless keys that should be
 gotten rid of in the author's opinion.
 
 </DD>
-<DT><A NAME="foot1488">... window.</A><A
+<DT><A NAME="foot1492">... window.</A><A
  HREF="node4.html#tex2html9"><SUP><SPAN CLASS="arabic">3</SPAN>.<SPAN CLASS="arabic">3</SPAN></SUP></A></DT>
 <DD>There's a patch to <TT>xprop</TT> to
 fix this, but nothing seems to be happening with respect to including it in 
index 7fe37d1f2b5b31f06059c9c9ef58768eff97b1a0..2db991c86a4ffc5e1d877398174ccbe072970c4c 100644 (file)
@@ -128,7 +128,7 @@ user attributes are explained in Sections <A HREF="#sec:grmisc">4.3</A>.
 <P>
 
 <H2><A NAME="SECTION00510000000000000000"></A>
-<A NAME="sec:engines"></A><A NAME="1905"></A><A NAME="1906"></A>
+<A NAME="sec:engines"></A><A NAME="1909"></A><A NAME="1910"></A>
 <BR>
 <SPAN CLASS="arabic">4</SPAN>.<SPAN CLASS="arabic">1</SPAN> Drawing engines, style specifications and sub-styles
 </H2>
@@ -180,7 +180,7 @@ specified, also in the form
 <PRE>
 attr1-attr2-...-attrn
 </PRE>
-These extra attributes are called <SPAN  CLASS="textit">substyles</SPAN><A NAME="1918"></A>
+These extra attributes are called <SPAN  CLASS="textit">substyles</SPAN><A NAME="1922"></A>
 and allow, for example, the state of the object to be indicated 
 by  different colour sets while keeping the interface at an 
 abstract level and the drawing engine completely ignorant 
@@ -424,7 +424,7 @@ border elements and styles referred to there are explained in Figure
 
 <P>
 
-<DIV ALIGN="CENTER"><A NAME="fig:borders"></A><A NAME="2021"></A>
+<DIV ALIGN="CENTER"><A NAME="fig:borders"></A><A NAME="2025"></A>
 <TABLE>
 <CAPTION ALIGN="BOTTOM"><STRONG>Figure 4.1:</STRONG>
 Sketch of different border styles and elements</CAPTION>
index 06d5f0602725e4b95895ba0c7ac8f2796c17aaef..4a3e772f4c3e2bc0295f167b21d99d11e472a62f 100644 (file)
@@ -5849,7 +5849,7 @@ Any parameters not explicitly set in <TT>conftab</TT> will be left unchanged.
 <P>
 
   <DL>
-<DD><A NAME="8266"></A>
+<DD><A NAME="8270"></A>
 
 </DD>
 <DT><STRONG>Hook name:</STRONG></DT>
@@ -5921,7 +5921,7 @@ reg:attach(cwin)
 <P>
 
   <DL>
-<DD><A NAME="8267"></A>
+<DD><A NAME="8271"></A>
 
 </DD>
 <DT><STRONG>Hook name:</STRONG></DT>
@@ -5941,7 +5941,7 @@ reg:attach(cwin)
 <P>
 
   <DL>
-<DD><A NAME="8268"></A>
+<DD><A NAME="8272"></A>
 
 </DD>
 <DT><STRONG>Hook name:</STRONG></DT>
@@ -5962,7 +5962,7 @@ reg:attach(cwin)
 <P>
 
   <DL>
-<DD><A NAME="8269"></A>
+<DD><A NAME="8273"></A>
 
 </DD>
 <DT><STRONG>Hook name:</STRONG></DT>
@@ -5983,7 +5983,7 @@ reg:attach(cwin)
 <P>
 
   <DL>
-<DD><A NAME="8270"></A>
+<DD><A NAME="8274"></A>
 
 </DD>
 <DT><STRONG>Hook name:</STRONG></DT>
@@ -6029,7 +6029,7 @@ reg:attach(cwin)
 <P>
 
   <DL>
-<DD><A NAME="8271"></A>
+<DD><A NAME="8275"></A>
 
 </DD>
 <DT><STRONG>Hook name:</STRONG></DT>
@@ -6050,7 +6050,7 @@ reg:attach(cwin)
 <P>
 
   <DL>
-<DD><A NAME="8272"></A>
+<DD><A NAME="8276"></A>
 
 </DD>
 <DT><STRONG>Hook name:</STRONG></DT>
@@ -6070,7 +6070,7 @@ reg:attach(cwin)
 <P>
 
   <DL>
-<DD><A NAME="8273"></A>
+<DD><A NAME="8277"></A>
 
 </DD>
 <DT><STRONG>Hook name:</STRONG></DT>
@@ -6091,7 +6091,7 @@ reg:attach(cwin)
 <P>
 
   <DL>
-<DD><A NAME="8274"></A>
+<DD><A NAME="8278"></A>
 
 </DD>
 <DT><STRONG>Hook name:</STRONG></DT>
@@ -6111,7 +6111,7 @@ reg:attach(cwin)
 <P>
 
   <DL>
-<DD><A NAME="8275"></A>
+<DD><A NAME="8279"></A>
 
 </DD>
 <DT><STRONG>Hook name:</STRONG></DT>
@@ -6131,7 +6131,7 @@ reg:attach(cwin)
 <P>
 
   <DL>
-<DD><A NAME="8276"></A>
+<DD><A NAME="8280"></A>
 
 </DD>
 <DT><STRONG>Hook name:</STRONG></DT>
@@ -6183,7 +6183,7 @@ reg:attach(cwin)
 <P>
 
   <DL>
-<DD><A NAME="8277"></A>
+<DD><A NAME="8281"></A>
 
 </DD>
 <DT><STRONG>Hook name:</STRONG></DT>
@@ -6204,7 +6204,7 @@ reg:attach(cwin)
 <P>
 
   <DL>
-<DD><A NAME="8278"></A>
+<DD><A NAME="8282"></A>
 
 </DD>
 <DT><STRONG>Hook name:</STRONG></DT>
@@ -6226,7 +6226,7 @@ reg:attach(cwin)
 <P>
 
   <DL>
-<DD><A NAME="8279"></A>
+<DD><A NAME="8283"></A>
 
 </DD>
 <DT><STRONG>Hook name:</STRONG></DT>
index e60a0f1b99a35838187139030ee3ddf3e44050b7..d23f9516aa1eda2465ea0c21e768076ceed4eeee 100644 (file)
Binary files a/ionnotes.dvi.gz and b/ionnotes.dvi.gz differ
index cc68c9b1ff56e0cef6888851fa8c47131f443179..2fb8ef876e9b51445db53b0275ba6a5111f251a3 100644 (file)
Binary files a/ionnotes.ps.gz and b/ionnotes.ps.gz differ
index 0397397a55c7fc3ebcec8769bcc4e86d695810e2..b3c05afc168ebd3b6176e184c05f8685cc1e3ee3 100644 (file)
@@ -70,7 +70,7 @@ Mathematics Department, Macquarie University, Sydney.
 The command line arguments were: <BR>
  <STRONG>latex2html</STRONG> <TT>-show_section_numbers -short_index -local_icons -noaddress -up_url http://iki.fi/tuomov/ion/ -up_title 'Ion homepage' -nofootnode -split 4 ionnotes</TT>
 <P>
-The translation was initiated by tuomov on 2007-09-02
+The translation was initiated by tuomov on 2007-09-27
 <BR><HR>
 
 </BODY>