[pitivi] help: overall improvements in trimming.page

[Jean-François Fortin Tam <jfft src gnome org>]

commit 673676cb60f968d1c755e31d996710ec8c2422e5
Author: Tomas Karger <tomkarger gmail com>
Date:   Mon Mar 17 14:30:59 2014 +0100

    help: overall improvements in trimming.page

 help/C/trimming.page |   52 ++++++++++++++++++++++++++++---------------------
 1 files changed, 30 insertions(+), 22 deletions(-)
---
diff --git a/help/C/trimming.page b/help/C/trimming.page
index f05d7a7..57b88d0 100644
--- a/help/C/trimming.page
+++ b/help/C/trimming.page
@@ -6,7 +6,7 @@
   <info>
     <link type="guide" xref="index#timeline"/>
     <link type="seealso" xref="splitting"/>
-    <revision pkgversion="0.13.4" version="0.1" date="2010-12-05" status="complete"/>
+    <revision pkgversion="0.92" version="0.1" date="2014-03-17" status="complete"/>
     <credit type="author">
       <name>Jean-François Fortin Tam</name>
       <email>nekohayo gmail com</email>
@@ -14,6 +14,8 @@
     <credit type="contributor">
       <name>Mario Blättermann</name>
       <email>mariobl gnome org</email>
+      <name>Tomáš Karger</name>
+      <email>tomkarger gmail com</email>
     </credit>
     <desc>
       Shortening clips by changing the beginning and ending points. Also covers ripple and roll editing.
@@ -24,56 +26,62 @@
   </info>
 
     <title>Trimming</title>
-     
-     <p>Trimming is the act of changing the beginning or end point of a clip in the timeline.</p>
 
-     <section>
-      <title>Trimming an individual clip</title>
-       <p>Move the mouse cursor over a clip, and trimming handles will appear. Drag one of the trimming 
handles on the left or right edge of the clip to trim.</p>
+       <p><em>Trimming</em> is the act of changing the length of a clip by moving its beginning or end point 
in the timeline. Move the mouse cursor over the edge of a clip and a trimming handle will appear. Drag the 
trimming handle in an appropriate direction to either reduce or increase the length of the clip.</p>
        <figure>
+       <title>Trimming handle</title>
+       <desc>The mouse cursor transforms into trimming handle when hovering over the edge of a clip.</desc>
         <media type="image" src="figures/trimming-individual.png" mime="image/png" style="right"></media>
        </figure>
-       <p>Clips that are grouped together, such as a video clip with its associated audio clip, will trim in 
unison when you drag the trimming handles. To trim only the audio or only the video part, you need to ungroup 
them first (see the section on Grouping/linking).</p>
-     </section>
+       <p>Clips that are grouped together, such as corresponding audio and video clips, will trim in unison 
when you drag the trimming handle. To trim only the audio or only the video clip, you need to ungroup them 
first (see the <link xref="selectiongrouping">Selection and grouping</link> page for instructions on how to 
do that).</p>
 
      <section>
       <title>Ripple editing</title>
-       <p>Ripple edits are a variant of basic trimming which, in addition to trimming a clip, moves the 
“following” clips (the clips that start after the one you're directly editing) to fill the gap.</p>
-       <note>
-        <p>The ripple applies to all “following” clips, regardless of whether or not they are on the same 
layer.</p>
-       </note>
-       <p>Before:</p>
+       <p>Ripple editing is a variant of basic trimming which, in addition to trimming a clip, also moves 
the following clips (the clips that start after the one you're directly editing) so that their relative 
position to the edited clip stays the same.</p>
        <figure>
+        <title>Before</title>
+        <desc>Relative position of two adjacent clips before ripple editing</desc>
         <media type="image" src="figures/ripple-before.png" mime="image/png" style="right"></media>
        </figure>
-       <p>After:</p>
        <figure>
+        <title>After</title>
+        <desc>Relative position of two adjacent clips after ripple editing</desc>
         <media type="image" src="figures/ripple-after.png" mime="image/png" style="right"></media>
        </figure>
+       <note>
+           <p>Note that if there is a gap between the clips, the following clip moves toward the edited so 
that the gap length stays the same.</p>
+       </note>
+       <note>
+        <p>Ripple editing affects all following clips, regardless of whether or not they are on the same 
layer.</p>
+       </note>
        <p>To do a ripple edit:
        </p>
        <steps>
-        <item><p>Place the mouse cursor on a trimming handle between two adjacent clips.</p></item>
+        <item><p>Place the mouse cursor on a trimming handle.</p></item>
         <item><p>Press and hold <key>Shift</key>.</p></item>
         <item><p>Drag the trimming handle.</p></item>
        </steps>
-       <p>Ripple editing can also be used when moving clips around in the timeline. For detailed 
explanations on how to do this, see the section <link xref="usingclips">Using ripple editing while moving 
clips</link>.</p>
+       <note style="tip">
+           <p>Ripple editing can also be used when moving clips around in the timeline. For detailed 
explanations on how to do this, see the section <link xref="usingclips">Using ripple editing while moving 
clips</link>.</p>
+       </note>
      </section>
 
      <section>
       <title>Roll editing</title>
-       <p>Roll edits are a variant of basic trimming which, in addition to trimming a clip, <em>trims</em> 
the adjacent clips to prevent creating gaps.</p>
-       <note>
-        <p>The roll applies to all temporally adjacent clips, regardless of whether or not they are on the 
same layer.</p>
-       </note>
-       <p>Before:</p>
+       <p>Roll editing is a variant of basic trimming which, in addition to trimming a clip, <em>trims</em> 
the adjacent clips in a complementary way to prevent creating gaps.</p>
        <figure>
+        <title>Before</title>
+        <desc>Relative position of two adjacent clips before roll editing</desc>
         <media type="image" src="figures/roll-before.png" mime="image/png" style="right"></media>
        </figure>
-       <p>After:</p>
        <figure>
+        <title>After</title>
+        <desc>Relative position of two adjacent clips after roll editing</desc>
         <media type="image" src="figures/roll-after.png" mime="image/png" style="right"></media>
        </figure>
+       <note>
+        <p>Roll editing affects all adjacent clips, regardless of whether or not they are on the same 
layer.</p>
+       </note>
        <p>To do a roll edit:</p>
         <steps>
         <item><p>Place the mouse cursor on a trimming handle between two adjacent clips.</p></item>