cookbook: Add a short introduction for the Text chapter

diff --git a/doc/cookbook/text.xml b/doc/cookbook/text.xml
index 4a0621d..d10551e 100644 (file)
--- a/doc/cookbook/text.xml
+++ b/doc/cookbook/text.xml
@@ -6,14 +6,24 @@
   <title>Text</title>
 
   <epigraph>
-    <attribution>Antoine de Saint-Exupery</attribution>
-    <para>A rock pile ceases to be a rock pile the moment a single man
-    contemplates it, bearing within him the image of a cathedral.</para>
+    <attribution>Alan Perlis</attribution>
+    <para>A picture is worth 10K words - but only those to describe the
+    picture. Hardly any sets of 10K words can be adequately described with
+    pictures.</para>
   </epigraph>
 
   <section id="text-introduction">
     <title>Introduction</title>
 
+    <para>User interfaces can rely on textures to represent actions, but there
+    are cases where you need to convey an idea using words.</para>
+
+    <para>Clutter provides an actor that allows displaying and editing
+    arbitrary text, called <type>ClutterText</type>. A <type>ClutterText</type>
+    actor can be positioned like any other actor; its preferred size is
+    determined by its contents, as well as the font family and size used to
+    render those contents.</para>
+
   </section>
 
   <section id="text-shadow">