From 7fee8cf26a07a41910ca730a4c22b61ddbc1e372 Mon Sep 17 00:00:00 2001
From: Emmanuele Bassi <ebassi@linux.intel.com>
Date: Fri, 3 Sep 2010 15:44:03 +0100
Subject: [PATCH] cookbook: Add a short introduction for the Text chapter

---
 doc/cookbook/text.xml | 16 +++++++++++++---
 1 file changed, 13 insertions(+), 3 deletions(-)

diff --git a/doc/cookbook/text.xml b/doc/cookbook/text.xml
index 4a0621d21..d10551e75 100644
--- 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">