]> git.decadent.org.uk Git - ion3-doc.git/blobdiff - ionconf/node5.html
projects / ion3-doc.git / blobdiff
? search:
summary | shortlog | log | commit | commitdiff | tree
raw | inline | side by side
[svn-upgrade] Integrating new upstream version, ion3 (20070318)
[ion3-doc.git] / ionconf / node5.html
diff --git a/ionconf/node5.html b/ionconf/node5.html
index b6951d4e9655dddfe91a9ae265942b0ccd9a4128..de5ae5ec4bc23893e205c9a005e7cc940289f971 100644 (file)
--- a/ionconf/node5.html
+++ b/ionconf/node5.html
@@ -28,31 +28,31 @@ original version by:  Nikos Drakos, CBLU, University of Leeds
 <BODY >
 
 <DIV CLASS="navigation"><!--Navigation Panel-->
-<A NAME="tex2html297"
+<A NAME="tex2html304"
   HREF="node6.html">
 <IMG WIDTH="37" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="next" SRC="next.png"></A> 
-<A NAME="tex2html291"
+<A NAME="tex2html298"
   HREF="ionconf.html">
 <IMG WIDTH="26" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="up" SRC="up.png"></A> 
-<A NAME="tex2html285"
+<A NAME="tex2html292"
   HREF="node4.html">
 <IMG WIDTH="63" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="previous" SRC="prev.png"></A> 
-<A NAME="tex2html293"
+<A NAME="tex2html300"
   HREF="node1.html">
 <IMG WIDTH="65" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="contents" SRC="contents.png"></A> 
-<A NAME="tex2html295"
+<A NAME="tex2html302"
   HREF="node11.html">
 <IMG WIDTH="43" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="index" SRC="index.png"></A> 
 <BR>
-<B> Next:</B> <A NAME="tex2html298"
+<B> Next:</B> <A NAME="tex2html305"
   HREF="node6.html">5. Scripting</A>
-<B> Up:</B> <A NAME="tex2html292"
+<B> Up:</B> <A NAME="tex2html299"
   HREF="ionconf.html">Configuring and extending Ion3</A>
-<B> Previous:</B> <A NAME="tex2html286"
+<B> Previous:</B> <A NAME="tex2html293"
   HREF="node4.html">3. Basic configuration</A>
- &nbsp; <B>  <A NAME="tex2html294"
+ &nbsp; <B>  <A NAME="tex2html301"
   HREF="node1.html">Contents</A></B> 
- &nbsp; <B>  <A NAME="tex2html296"
+ &nbsp; <B>  <A NAME="tex2html303"
   HREF="node11.html">Index</A></B> 
 <BR>
 <BR></DIV>
@@ -61,50 +61,50 @@ original version by:  Nikos Drakos, CBLU, University of Leeds
 <A NAME="CHILD_LINKS"><STRONG>Subsections</STRONG></A>
 
 <UL CLASS="ChildLinks">
-<LI><A NAME="tex2html299"
+<LI><A NAME="tex2html306"
   HREF="node5.html#SECTION00510000000000000000"><SPAN CLASS="arabic">4</SPAN>.<SPAN CLASS="arabic">1</SPAN> Drawing engines, style specifications and sub-styles</A>
 <UL>
-<LI><A NAME="tex2html300"
+<LI><A NAME="tex2html307"
   HREF="node5.html#SECTION00511000000000000000"><SPAN CLASS="arabic">4</SPAN>.<SPAN CLASS="arabic">1</SPAN>.<SPAN CLASS="arabic">1</SPAN> Known styles and substyles</A>
 <UL>
-<LI><A NAME="tex2html301"
+<LI><A NAME="tex2html308"
   HREF="node5.html#SECTION00511100000000000000"><SPAN CLASS="arabic">4</SPAN>.<SPAN CLASS="arabic">1</SPAN>.<SPAN CLASS="arabic">1</SPAN>.<SPAN CLASS="arabic">1</SPAN> Frames</A>
-<LI><A NAME="tex2html302"
+<LI><A NAME="tex2html309"
   HREF="node5.html#SECTION00511200000000000000"><SPAN CLASS="arabic">4</SPAN>.<SPAN CLASS="arabic">1</SPAN>.<SPAN CLASS="arabic">1</SPAN>.<SPAN CLASS="arabic">2</SPAN> Tabs and menu entries</A>
-<LI><A NAME="tex2html303"
+<LI><A NAME="tex2html310"
   HREF="node5.html#SECTION00511300000000000000"><SPAN CLASS="arabic">4</SPAN>.<SPAN CLASS="arabic">1</SPAN>.<SPAN CLASS="arabic">1</SPAN>.<SPAN CLASS="arabic">3</SPAN> The rest</A>
 </UL>
 </UL>
 <BR>
-<LI><A NAME="tex2html304"
+<LI><A NAME="tex2html311"
   HREF="node5.html#SECTION00520000000000000000"><SPAN CLASS="arabic">4</SPAN>.<SPAN CLASS="arabic">2</SPAN> Defining styles for the default drawing engine</A>
 <UL>
-<LI><A NAME="tex2html305"
+<LI><A NAME="tex2html312"
   HREF="node5.html#SECTION00521000000000000000"><SPAN CLASS="arabic">4</SPAN>.<SPAN CLASS="arabic">2</SPAN>.<SPAN CLASS="arabic">1</SPAN> The structure of the configuration files</A>
-<LI><A NAME="tex2html306"
+<LI><A NAME="tex2html313"
   HREF="node5.html#SECTION00522000000000000000"><SPAN CLASS="arabic">4</SPAN>.<SPAN CLASS="arabic">2</SPAN>.<SPAN CLASS="arabic">2</SPAN> Defining the styles</A>
 <UL>
-<LI><A NAME="tex2html307"
+<LI><A NAME="tex2html314"
   HREF="node5.html#SECTION00522100000000000000"><SPAN CLASS="arabic">4</SPAN>.<SPAN CLASS="arabic">2</SPAN>.<SPAN CLASS="arabic">2</SPAN>.<SPAN CLASS="arabic">1</SPAN> Colours</A>
-<LI><A NAME="tex2html308"
+<LI><A NAME="tex2html315"
   HREF="node5.html#SECTION00522200000000000000"><SPAN CLASS="arabic">4</SPAN>.<SPAN CLASS="arabic">2</SPAN>.<SPAN CLASS="arabic">2</SPAN>.<SPAN CLASS="arabic">2</SPAN> Borders and widths</A>
-<LI><A NAME="tex2html309"
+<LI><A NAME="tex2html316"
   HREF="node5.html#SECTION00522300000000000000"><SPAN CLASS="arabic">4</SPAN>.<SPAN CLASS="arabic">2</SPAN>.<SPAN CLASS="arabic">2</SPAN>.<SPAN CLASS="arabic">3</SPAN> Text</A>
-<LI><A NAME="tex2html310"
+<LI><A NAME="tex2html317"
   HREF="node5.html#SECTION00522400000000000000"><SPAN CLASS="arabic">4</SPAN>.<SPAN CLASS="arabic">2</SPAN>.<SPAN CLASS="arabic">2</SPAN>.<SPAN CLASS="arabic">4</SPAN> Miscellaneous</A>
-<LI><A NAME="tex2html311"
+<LI><A NAME="tex2html318"
   HREF="node5.html#SECTION00522500000000000000"><SPAN CLASS="arabic">4</SPAN>.<SPAN CLASS="arabic">2</SPAN>.<SPAN CLASS="arabic">2</SPAN>.<SPAN CLASS="arabic">5</SPAN> Substyles</A>
 </UL>
-<LI><A NAME="tex2html312"
+<LI><A NAME="tex2html319"
   HREF="node5.html#SECTION00523000000000000000"><SPAN CLASS="arabic">4</SPAN>.<SPAN CLASS="arabic">2</SPAN>.<SPAN CLASS="arabic">3</SPAN> An example</A>
 </UL>
 <BR>
-<LI><A NAME="tex2html313"
+<LI><A NAME="tex2html320"
   HREF="node5.html#SECTION00530000000000000000"><SPAN CLASS="arabic">4</SPAN>.<SPAN CLASS="arabic">3</SPAN> Miscellaneous settings</A>
 <UL>
-<LI><A NAME="tex2html314"
+<LI><A NAME="tex2html321"
   HREF="node5.html#SECTION00531000000000000000"><SPAN CLASS="arabic">4</SPAN>.<SPAN CLASS="arabic">3</SPAN>.<SPAN CLASS="arabic">1</SPAN> Extra fields for style <TT>frame</TT></A>
-<LI><A NAME="tex2html315"
+<LI><A NAME="tex2html322"
   HREF="node5.html#SECTION00532000000000000000"><SPAN CLASS="arabic">4</SPAN>.<SPAN CLASS="arabic">3</SPAN>.<SPAN CLASS="arabic">2</SPAN> Extra fields for style <TT>dock</TT></A>
 </UL></UL>
 <!--End of Table of Child-Links-->
@@ -125,7 +125,7 @@ for the default drawing engine.
 <P>
 
 <H2><A NAME="SECTION00510000000000000000"></A>
-<A NAME="sec:engines"></A><A NAME="1665"></A><A NAME="1666"></A>
+<A NAME="sec:engines"></A><A NAME="1708"></A><A NAME="1709"></A>
 <BR>
 <SPAN CLASS="arabic">4</SPAN>.<SPAN CLASS="arabic">1</SPAN> Drawing engines, style specifications and sub-styles
 </H2>
@@ -169,7 +169,6 @@ foo-bar-baz
 foo-*-baz
 foo-bar
 *
-foo-baz   -- Doesn't match, not selected!
 </PRE>
 
 <P>
@@ -178,7 +177,7 @@ specified, also in the form
 <PRE>
 attr1-attr2-...-attrn
 </PRE>
-These extra attributes are called <SPAN  CLASS="textit">substyles</SPAN><A NAME="1677"></A>
+These extra attributes are called <SPAN  CLASS="textit">substyles</SPAN><A NAME="1720"></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 
@@ -209,11 +208,15 @@ tag and drag states.)
 </TR>
 <TR><TD ALIGN="LEFT"><TT>frame</TT></TD>
 <TD ALIGN="LEFT">Style for frames. 
-       Substyles: <TT>active</TT>, <TT>inactive</TT>.</TD>
+       Substyle attributes: <TT>active</TT>/<TT>inactive</TT> 
+       (mutually exclusive) and
+       <TT>quasiactive</TT>/<TT>not_quasiactive</TT>. 
+       A frame is ``quasiactive'' when an active region
+       has a backlink to it, such as a detached window.</TD>
 </TR>
 <TR><TD ALIGN="LEFT"><TT>frame-tiled</TT></TD>
 <TD ALIGN="LEFT">A more specific style for tiled frames.
-        Substyles as for <TT>frame</TT>.</TD>
+        Substyle attributes as for <TT>frame</TT>.</TD>
 </TR>
 <TR><TD ALIGN="LEFT"><TT>frame-tiled-alt</TT></TD>
 <TD ALIGN="LEFT">An alternative style for tiled frames.
@@ -242,17 +245,17 @@ tag and drag states.)
 </TR>
 <TR><TD ALIGN="LEFT"><TT>tab</TT></TD>
 <TD ALIGN="LEFT">Style for frames' tabs and menu entries. 
-       Substyles: combinations of the form <TT>a-s</TT> where
-       <TT>a</TT> is one of <TT>active</TT>/<TT>inactive</TT> and
-       <TT>s</TT> is one of <TT>selected</TT>/<TT>unselected</TT></TD>
+       Substyle attributes:
+       <TT>active</TT>/<TT>inactive</TT> and
+       <TT>selected</TT>/<TT>unselected</TT></TD>
 </TR>
 <TR><TD ALIGN="LEFT"><TT>tab-frame</TT></TD>
 <TD ALIGN="LEFT">A more specific style for frames' tabs.
-       Substyles: combinations of the form <TT>a-s-t-d-u</TT> where
-       <TT>a</TT> and <TT>s</TT> are as above and
-       <TT>t</TT> is one of <TT>tagged</TT>/<TT>not_tagged</TT>,
-       <TT>d</TT> is one of <TT>dragged</TT>/<TT>not_dragged</TT> and
-       <TT>u</TT> is one of <TT>activity</TT>/<TT>no_activity</TT>.</TD>
+        Additional substyle attributes include:
+       <TT>tagged</TT>/<TT>not_tagged</TT>,
+       <TT>dragged</TT>/<TT>not_dragged</TT>,
+       <TT>activity</TT>/<TT>no_activity</TT> and
+       <TT>quasiactive</TT>/<TT>not_quasiactive</TT>.</TD>
 </TR>
 <TR><TD ALIGN="LEFT"><TT>tab-frame-tiled</TT>,</TD>
 <TD ALIGN="LEFT">&nbsp;</TD>
@@ -268,7 +271,9 @@ tag and drag states.)
         different modes.</TD>
 </TR>
 <TR><TD ALIGN="LEFT"><TT>tab-menuentry</TT></TD>
-<TD ALIGN="LEFT">A more specific style for entries in WMenus.</TD>
+<TD ALIGN="LEFT">A more specific style for entries in WMenus. 
+        Additional substyle attributes include <TT>submenu</TT> and
+        occasionally also <TT>activity</TT> is used.</TD>
 </TR>
 <TR><TD ALIGN="LEFT"><TT>tab-menuentry-bigmenu</TT></TD>
 <TD ALIGN="LEFT">An alternate style for entries in WMenus.</TD>
@@ -291,7 +296,7 @@ tag and drag states.)
 </TR>
 <TR><TD ALIGN="LEFT"><TT>input-edln</TT></TD>
 <TD ALIGN="LEFT">A more specific style for WEdlns. 
-       Substyles: <TT>selection</TT> for selected text and
+       Substyle attributes: <TT>selection</TT> for selected text and
        <TT>cursor</TT> for the cursor indicating current editing point.</TD>
 </TR>
 <TR><TD ALIGN="LEFT"><TT>input-message</TT></TD>
@@ -335,7 +340,7 @@ and should usually be symlinked to or a copy of of some
 </H3>
 
 <P>
-The first thing to do in a stylefile is to choose the drawing
+The first thing to do in a style file is to choose the drawing
 engine, possibly loading the module as well. This is done
 with the following chunk of code.
 
@@ -407,7 +412,7 @@ border elements and styles referred to there are explained in Figure
 
 <P>
 
-<DIV ALIGN="CENTER"><A NAME="fig:borders"></A><A NAME="1777"></A>
+<DIV ALIGN="CENTER"><A NAME="fig:borders"></A><A NAME="1817"></A>
 <TABLE>
 <CAPTION ALIGN="BOTTOM"><STRONG>Figure 4.1:</STRONG>
 Sketch of different border styles and elements</CAPTION>
@@ -483,6 +488,12 @@ indicating a number of pixels.
                     elevated/inlaid/ridge/groove as seen in the
                     above sketch.</TD>
 </TR>
+<TR><TD ALIGN="LEFT"><TT>border_sides</TT></TD>
+<TD ALIGN="LEFT">A string indicating which sides of the border
+                     to draw: all/tb/lr for all, top and bottom, and
+                     left and right. To control between left/right
+                     and top/bottom, use the pixel options below.</TD>
+</TR>
 <TR><TD ALIGN="LEFT"><TT>highlight_pixels</TT></TD>
 <TD ALIGN="LEFT">Width of the highlight part of the border in pixels.</TD>
 </TR>
@@ -688,31 +699,31 @@ style configuration files.
 
 <DIV CLASS="navigation"><HR>
 <!--Navigation Panel-->
-<A NAME="tex2html297"
+<A NAME="tex2html304"
   HREF="node6.html">
 <IMG WIDTH="37" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="next" SRC="next.png"></A> 
-<A NAME="tex2html291"
+<A NAME="tex2html298"
   HREF="ionconf.html">
 <IMG WIDTH="26" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="up" SRC="up.png"></A> 
-<A NAME="tex2html285"
+<A NAME="tex2html292"
   HREF="node4.html">
 <IMG WIDTH="63" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="previous" SRC="prev.png"></A> 
-<A NAME="tex2html293"
+<A NAME="tex2html300"
   HREF="node1.html">
 <IMG WIDTH="65" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="contents" SRC="contents.png"></A> 
-<A NAME="tex2html295"
+<A NAME="tex2html302"
   HREF="node11.html">
 <IMG WIDTH="43" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="index" SRC="index.png"></A> 
 <BR>
-<B> Next:</B> <A NAME="tex2html298"
+<B> Next:</B> <A NAME="tex2html305"
   HREF="node6.html">5. Scripting</A>
-<B> Up:</B> <A NAME="tex2html292"
+<B> Up:</B> <A NAME="tex2html299"
   HREF="ionconf.html">Configuring and extending Ion3</A>
-<B> Previous:</B> <A NAME="tex2html286"
+<B> Previous:</B> <A NAME="tex2html293"
   HREF="node4.html">3. Basic configuration</A>
- &nbsp; <B>  <A NAME="tex2html294"
+ &nbsp; <B>  <A NAME="tex2html301"
   HREF="node1.html">Contents</A></B> 
- &nbsp; <B>  <A NAME="tex2html296"
+ &nbsp; <B>  <A NAME="tex2html303"
   HREF="node11.html">Index</A></B> </DIV>
 <!--End of Navigation Panel-->
 
Package: Ion3 docs [unmaintained]