cvsimport
[fvwm.git] / doc / fvwm / colorsets.xml
blobbcb4eddde7e88b16dff5fb9f0e180405b6161114
1 <?xml version="1.0" encoding="UTF-8" ?>
2 <!DOCTYPE part PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
3   "../docbook-xml/docbookx.dtd"
5 <!ENTITY % myents SYSTEM "../fvwm.ent" >
6 %myents;
7 ]>
9 <!-- $Id: colorsets.xml,v 1.2 2007/08/06 22:24:03 domivogt Exp $ -->
11 <section id='colorsets'>
12 <title>Colorsets</title>
14 <para>Colorsets are a powerful method to control colors. Colorsets
15 create appearance resources that are shared by fvwm and its
16 modules.  When a colorset is modified all parts of fvwm react to
17 that change. A colorset includes a foreground color, background
18 color, shadow and highlight color (often based on the background
19 color), background face (this includes images and all kinds of
20 gradients).  There is a way to render background face and specify
21 other color operations.</para>
23 <para>In the 2.4.x versions a special module
24 <fvwmref mod="FvwmTheme"/>
25 was introduced to manage colorsets.  Starting with the 2.5.x beta
26 version, the <fvwmref mod="FvwmTheme"/> functionality was moved to the core fvwm,
27 so this module became obsolete.</para>
29 <para>The old syntax:</para>
31 <programlisting>
32 <fvwmref cmd="DestroyModuleConfig"/> <fvwmref mod="FvwmTheme"/>: *
33 *<fvwmref mod="FvwmTheme"/>: <fvwmref cmd="Colorset"/> 0 fg black, bg rgb:b4/aa/94
34 *<fvwmref mod="FvwmTheme"/>: <fvwmref cmd="Colorset"/> 1 fg black, bg rgb:a1/b2/c8
35 </programlisting>
37 <para>corresponds to the new syntax:</para>
39 <programlisting>
40 <fvwmref cmd="CleanupColorsets"/>
41 <fvwmref cmd="Colorset"/> 0 fg black, bg rgb:b4/aa/94
42 <fvwmref cmd="Colorset"/> 1 fg black, bg rgb:a1/b2/c8
43 </programlisting>
47 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="Colorset.xml" />
48 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="CleanupColorsets.xml" />
49 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="colorGradients.xml" />
52 </section>