docs/manual/: Add one more image showing different times together with a describing paragraph. Fixes #547729.

Original commit message from CVS:
patch by: Luc Pionchon <luc.pionchon@nokia.com>
* docs/manual/advanced-clocks.xml:
* docs/manual/clocks.png:
* docs/manual/diagrams-clocks.svg:
Add one more image showing different times together with a describing
paragraph. Fixes #547729.

ChangeLog

@@ -1,3 +1,13 @@
+2008-08-14  Stefan Kost  <ensonic@users.sf.net>
+
+	patch by: Luc Pionchon <luc.pionchon@nokia.com>
+
+	* docs/manual/advanced-clocks.xml:
+	* docs/manual/clocks.png:
+	* docs/manual/diagrams-clocks.svg:
+	  Add one more image showing different times together with a describing
+	  paragraph. Fixes #547729.
+
 2008-08-14  Wim Taymans  <wim.taymans@collabora.co.uk>
 
 	* win32/common/libgstbase.def:

docs/manual/advanced-clocks.xml

@@ -10,6 +10,26 @@
     rate. If no clock provider is available in a pipeline, the system clock
     is used instead.
   </para>
+  
+  <para>
+    &GStreamer; derives several times from the clock and the playback state.
+    It is important to note, that a  <emphasis>clock-time</emphasis> is
+    monotonically rising, but the value itself is not meaningful.
+    Subtracting the <emphasis>base-time</emphasis> yields the
+    <emphasis>running-time</emphasis>. It is the same as the
+    <emphasis>stream-time</emphasis> if one plays from start to end at original
+    rate. The <emphasis>stream-time</emphasis> indicates the position in the
+    media.
+  </para>
+
+  <figure float="1" id="chapter-clock-img">
+    <title>&GStreamer; clock and various times</title>
+    <mediaobject>
+      <imageobject>
+        <imagedata scale="75" fileref="images/clocks.&image;" format="&IMAGE;" />
+      </imageobject>
+    </mediaobject>  
+  </figure>
 
   <sect1 id="section-clocks-providers">
     <title>Clock providers</title>