summaryrefslogtreecommitdiff
path: root/docs
diff options
context:
space:
mode:
authorDaniel Boles <dboles@src.gnome.org>2017-03-17 23:55:15 +0000
committerDaniel Boles <dboles@src.gnome.org>2017-03-17 23:56:25 +0000
commite5ae946be36589e7b946f3a87f8e41127caa872e (patch)
treec436cea5ec93e50740e1e0b1c6739814860d8587 /docs
parenta69083c95efd88ce2796671d983c0fc35891fde5 (diff)
downloadgtk+-e5ae946be36589e7b946f3a87f8e41127caa872e.tar.gz
css-overview: Elaborate how color expressions work
Diffstat (limited to 'docs')
-rw-r--r--docs/reference/gtk/css-overview.xml11
1 files changed, 8 insertions, 3 deletions
diff --git a/docs/reference/gtk/css-overview.xml b/docs/reference/gtk/css-overview.xml
index d5e6cf2cf3..3a7925e2b5 100644
--- a/docs/reference/gtk/css-overview.xml
+++ b/docs/reference/gtk/css-overview.xml
@@ -582,9 +582,14 @@ background-color: @bg_color;
</example>
<para>
- GTK+ also allows to form color expressions, which can be nested and
- provide a rich language to define colors which are derived from a
- set of base colors.
+ GTK+ also supports color expressions, which allow colors to be transformed
+ to new ones and can be nested, providing a rich language to define colors.
+ </para>
+ <para>
+ Color expressions resemble functions, taking 1 or more colors and in some
+ cases a number as their arguments. The number is floating-point, clamped
+ between 0 and 1, and specifies the degree to which the expression will
+ transform the given color(s) in the manner that is indicated by its name.
</para>
<literallayout><code>〈color expression〉 = lighter(〈color〉) | darker(〈color〉) | shade(〈color〉,〈number〉) | alpha(〈color〉,〈number〉) | mix(〈color〉,〈color〉,〈number〉)</code>