docs: fix some typos and add some missing links in the app dev manual

[platform/upstream/gstreamer.git] / docs / manual / advanced-clocks.xml

diff --git a/docs/manual/advanced-clocks.xml b/docs/manual/advanced-clocks.xml
index 33505ef..0435091 100644 (file)
--- a/docs/manual/advanced-clocks.xml
+++ b/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>
@@ -32,7 +52,7 @@
       need to start at 0. The pipeline, which contains the global clock that
       all elements in the pipeline will use, in addition has a <quote>base
       time</quote>, which is the clock time at the the point where media time
-      is starting from zero. This timestamp is subctracted from the clock
+      is starting from zero. This timestamp is subtracted from the clock
       time, and that value is returned by <function>_get_time ()</function>.
     </para>
     <para>