[gtk+] Revert "Update the CSS docs for the demise of define-color"

[Matthias Clasen <matthiasc src gnome org>]

commit fa7d77d40732281a8838a314bcc39a0007182320
Author: Matthias Clasen <mclasen redhat com>
Date:   Mon Nov 7 15:05:37 2016 -0500

    Revert "Update the CSS docs for the demise of define-color"
    
    This reverts commit 12d9451b1cb1e38e7431c552925d55e2d5fc3482.

 docs/reference/gtk/css-overview.xml   |   30 ++++++++++++++++++++++++++++--
 docs/reference/gtk/css-properties.xml |    4 +++-
 2 files changed, 31 insertions(+), 3 deletions(-)
---
diff --git a/docs/reference/gtk/css-overview.xml b/docs/reference/gtk/css-overview.xml
index 0fe3891..6afa20a 100644
--- a/docs/reference/gtk/css-overview.xml
+++ b/docs/reference/gtk/css-overview.xml
@@ -552,11 +552,37 @@ checkbutton:indeterminate {
       GTK+ adds several additional ways to specify colors.
     </para>
 
-<literallayout><code>〈gtk color〉 = 〈color expression〉| 〈win32 color〉</code>
+<literallayout><code>〈gtk color〉 = 〈symbolic color〉 | 〈color expression〉| 〈win32 color〉</code>
 </literallayout>
 
     <para>
-      GTK+ allows to form color expressions, which can be nested and
+      The first is a reference to a color defined via a @define-color rule.
+      The syntax for @define-color rules is as follows:
+    </para>
+
+<literallayout><code>〈define color rule〉 = @define-color 〈name〉 〈color〉</code>
+</literallayout>
+
+    <para>
+      To refer to the color defined by a @define-color rule,
+      use the name from the rule, prefixed with @.
+    </para>
+
+<literallayout><code>〈symbolic color〉 = @〈name〉</code>
+</literallayout>
+
+    <example><title>An example for defining colors</title>
+      <programlisting><![CDATA[
+@define-color bg_color #f9a039;
+
+* {
+background-color: @bg_color;
+}
+]]></programlisting>
+    </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.
     </para>
diff --git a/docs/reference/gtk/css-properties.xml b/docs/reference/gtk/css-properties.xml
index 9ab0c4b..1f9a662 100644
--- a/docs/reference/gtk/css-properties.xml
+++ b/docs/reference/gtk/css-properties.xml
@@ -480,7 +480,9 @@ We use <literallayout> for syntax productions, and each line is put in a <code>
       <para>
         -gtk-icon-palette defines a color palette for recoloring symbolic
         icons. The recognized names for colors in symbolic icons are error,
-        warning and success.
+        warning and success. The default palette maps these three names to
+        symbolic colors with the names @error_color, @warning_color and
+        @error_color.
       </para>
 
       <table pgwide="1">