[gtk+/wip/matthiasc/caret: 8/8] Document new CSS properties

[Matthias Clasen <matthiasc src gnome org>]

commit 79ba8a5f8e2c5ace4585d8a5ecacab3c681fedbe
Author: Matthias Clasen <mclasen redhat com>
Date:   Mon Jan 11 00:09:34 2016 -0500

    Document new CSS properties
    
    Add caret-animation, caret-shape and the caret shorthand to the docs.

 docs/reference/gtk/css-properties.xml |   54 +++++++++++++++++++++++++++++++++
 1 files changed, 54 insertions(+), 0 deletions(-)
---
diff --git a/docs/reference/gtk/css-properties.xml b/docs/reference/gtk/css-properties.xml
index 053cd14..635a17e 100644
--- a/docs/reference/gtk/css-properties.xml
+++ b/docs/reference/gtk/css-properties.xml
@@ -257,10 +257,64 @@ We use <literallayout> for syntax productions, and each line is put in a <code>
               <entry></entry>
               <entry>Used for the secondary caret in bidirectional text</entry>
             </row>
+            <row>
+              <entry>caret-animation</entry>
+              <entry><code>〈caret  animation〉</code></entry>
+              <entry><code>auto</code></entry>
+              <entry>✓</entry>
+              <entry>✓</entry>
+              <entry><ulink url="http://www.w3.org/TR/css-ui-4/#caret-animation";>CSS4</ulink></entry>
+              <entry>CSS allows a fade value</entry>
+            </row>
+            <row>
+              <entry>caret-shape</entry>
+              <entry><code>〈caret  shape〉</code></entry>
+              <entry><code>auto</code></entry>
+              <entry>✓</entry>
+              <entry>✓</entry>
+              <entry><ulink url="http://www.w3.org/TR/css-ui-4/#caret-shape";>CSS4</ulink></entry>
+              <entry></entry>
+            </row>
+          </tbody>
+        </tgroup>
+        <tgroup cols="5">
+          <thead>
+            
<row><entry>Shorthand</entry><entry>Value</entry><entry>Initial</entry><entry>Reference</entry><entry>Notes</entry></row>
+          </thead>
+          <tbody>
+            <row>
+              <entry>caret</entry>
+              <entry><code>〈caret-color〉 || 〈caret-animation〉 || 〈caret-shape〉</code></entry>
+              <entry>see individual properties</entry>
+              <entry><ulink url="http://www.w3.org/TR/css-ui-4/#caret";>CSS4</ulink></entry>
+              <entry>-gtk-secondary-caret-color is set to the same value as caret-color</entry>
+            </row>
           </tbody>
         </tgroup>
       </table>
 
+<literallayout><code>〈caret animation〉 = auto | blink | none</code>
+<code>〈caret shape〉 = auto | bar | block | underscore</code>
+</literallayout>
+
+      <para>
+        The text decoration properties determine whether to apply extra decorations
+        when rendering text.
+      </para>
+
+      <table pgwide="1">
+        <title>Icon Properties</title>
+        <tgroup cols="7">
+          <colspec colnum="4" align="center"/>
+          <colspec colnum="5" align="center"/>
+          <thead>
+            
<row><entry>Name</entry><entry>Value</entry><entry>Initial</entry><entry>Inh.</entry><entry>Ani.</entry><entry>Reference</entry><entry>Notes</entry></row>
+          </thead>
+          <tbody>
+            <row>
+              <entry>‑gtk‑icon‑source</entry>
+              <entry><code>builtin | 〈image〉 | none</code></entry>
+              <entry><code>builtin</code></entry>
       <para>
         The caret properties provide a way to change the appearance of the insertion
         caret in editable text.