[pitivi] help: minor improvements in layers.page

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

commit 1d948ffdf32e850af3a6729f64039b52a38d0739
Author: Tomas Karger <tomkarger gmail com>
Date:   Sat Feb 22 12:45:46 2014 +0100

    help: minor improvements in layers.page

 help/C/layers.page |   25 ++++++++++++++-----------
 1 files changed, 14 insertions(+), 11 deletions(-)
---
diff --git a/help/C/layers.page b/help/C/layers.page
index c078c46..b643fe6 100644
--- a/help/C/layers.page
+++ b/help/C/layers.page
@@ -5,7 +5,7 @@
 
   <info>
     <link type="guide" xref="index#timeline"/>
-    <revision pkgversion="0.13.4" version="0.1" date="2013-12-30" status="complete"/>
+    <revision pkgversion="0.92" version="0.1" date="2014-02-22" status="complete"/>
     <credit type="author">
       <name>Jean-François Fortin Tam</name>
       <email>nekohayo gmail com</email>
@@ -17,7 +17,7 @@
       <email>tomkarger gmail com</email>
     </credit>
     <desc>
-
+    Explaining how layers work within the timeline.
     </desc>
     <license>
       <p>Creative Commons Share Alike 3.0</p>
@@ -27,8 +27,7 @@
     <title>Understanding layers</title>
 
      <p><em>Layers</em> are a fundamental concept for advanced editing in the timeline: compositing, mixing 
multiple videos simultaneously, and adding titles depend on this feature.</p>
-     <p>It is easier to think of layers in terms of images painted on glass. With several pieces of glass 
stacked on top of each other, each of these pieces of glass is a layer. If the top piece of glass is 
completely painted over, none of the pieces of glass underneath will be visible.</p>
-     <p>If, on the other hand, you only paint over a portion of a piece of glass, you will be able to see 
what is underneath the non-painted parts.</p>
+     <p>It is easier to think of layers in terms of images painted on glass. With several pieces of glass 
stacked on top of each other, each of these pieces of glass is a layer. If the top piece of glass is 
completely painted over, none of the pieces of glass underneath will be visible. If, on the other hand, you 
only paint over a portion of a piece of glass, you will be able to see what is underneath the non-painted 
parts.</p>
 
      <section>
       <title>Opacity (how solid “opaque” things are)</title>
@@ -38,23 +37,27 @@
      <section>
       <title>How this translates in terms of user interface</title>
        <p>While, in real life, you can stack pieces of glass onto each other in three dimensions, your 
computer monitor only has two dimensions. Thus, the <em>layers on top</em> (the “Z” axis in the physical 
world) are also visually <em>on top</em>, albeit on the “Y” axis.</p>
-       <p>The following diagram illustrates the <em>pieces of glass</em> (left) and how they are show as 
<em>layers</em> in <app>Pitivi</app>'s user interface (right).</p>
        <figure>
-        <media type="image" src="figures/layers.png" mime="image/png" style="right"></media>
+       <desc>Diagram illustrating the <em>pieces of glass</em> (left) and how they are show as 
<em>layers</em> in <app>Pitivi</app>'s user interface (right).</desc>
+        <media type="image" src="figures/layers.png" mime="image/png" width="720" height="217"/>
        </figure>
-       <p>Clips located on a layer above will block the clips below from view, unless it has an opacity 
value lower than 100% (as shown with the two topmost layers in the previous illustration).</p>
+       <note>
+       <p>Clips located on a layer above will block the clips below from view, unless they have an opacity 
value lower than 100% (as shown with the two topmost layers in the previous illustration).</p>
+       </note>
      </section>
 
      <section>
       <title>Adding and removing layers</title>
-       <p>Layers are created and removed automatically. There is no “layer management” interface in 
<app>Pitivi</app> (at least, not yet).</p>
-       <p>To create a layer, drag a clip to the middle space between two existing layers. Once the grey 
shadow (a thin rectangle) appears between the layers, release it.</p>
-       <p>If there are no more clips on a layer, it is automatically removed. Thus, to remove a layer, 
simply drag its clips upwards onto another layer.</p>
+       <p>There is no “layer management” interface in <app>Pitivi</app>. Layers are created and removed 
automatically:</p>
+       <list>
+       <item><p>To create a layer, drag a clip to the middle space between two existing layers. Once the 
grey shadow (a thin rectangle) appears between the layers, release it.</p></item>
+       <item><p>If there are no more clips on a layer, it is automatically removed. Thus, to remove a layer, 
simply drag its clips onto another layer.</p></item>
+       </list>
      </section>
 
      <section>
       <title>What about audio layers?</title>
-       <p>Unlike in vision, multiple sounds do not (objectively) “block” each other. As such, if you have 
multiple audio clips on separate layers, their sound will be mixed together. Controlling the volume of those 
audio clips simply changes their relative loudness.</p>
+       <p>Unlike in vision, multiple sounds do not “block” each other. If you have multiple audio clips on 
separate layers, their sound will be mixed together. Controlling the volume of those audio clips simply 
changes their relative loudness.</p>
      </section>