[pitivi] help: reword and update gstreamer.page

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

commit 0bbc28798a5f4d4c37601f92eaec6e1f18bee3d1
Author: Tomas Karger <tomkarger gmail com>
Date:   Sun Apr 6 16:39:07 2014 +0200

    help: reword and update gstreamer.page

 help/C/gstreamer.page |   28 ++++++++++++++++------------
 1 files changed, 16 insertions(+), 12 deletions(-)
---
diff --git a/help/C/gstreamer.page b/help/C/gstreamer.page
index f99b1c2..1eae726 100644
--- a/help/C/gstreamer.page
+++ b/help/C/gstreamer.page
@@ -5,7 +5,7 @@
 
   <info>
     <link type="guide" xref="index#intro"/>
-    <revision pkgversion="0.14" version="0.2" date="2011-06-05" status="complete"/>
+    <revision pkgversion="0.93" version="0.2" date="2014-04-06" status="complete"/>
     <credit type="author">
       <name>Jean-François Fortin Tam</name>
       <email>nekohayo gmail com</email>
@@ -13,6 +13,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>
       Ensuring you have the proper multimedia codecs and plugins installed for maximum compatibility.
@@ -24,19 +26,19 @@
 
     <title>Gstreamer and compatibility</title>
 
-     <p>A great strength in <app>Pitivi</app> lies in its use of the <app>GStreamer</app> multimedia 
framework. <app>GStreamer</app> is used by dozens of multimedia applications across desktop environments, 
operating systems and architectures.</p>
-     <p>This essentially means three things to you, the user:</p>
+     <p>A great strength of <app>Pitivi</app> lies in the fact that it uses the <app>GStreamer</app> 
multimedia framework. <app>GStreamer</app> is used by dozens of multimedia applications across desktop 
environments, operating systems and architectures.</p>
+     <p>For <app>Pitivi</app> users, this essentially means two things:</p>
      <list>
       <item>
-       <p>You can, in theory, import pretty much any media file supported by <app>GStreamer</app> (but see 
the next section).</p>
+       <p>You can, in theory, import pretty much any media file supported by <app>GStreamer</app> (see the 
sections below for more details).</p>
       </item>
       <item>
        <p>You can render your projects using any supported container and codec combination from 
<app>GStreamer</app>.</p>
       </item>
-      <item>
-       <p>You need a very recent version of <app>GStreamer</app> to maximize <app>Pitivi's</app> 
capabilities and reduce the possibilities of bugs. This is because the <app>Pitivi</app> project developers 
work hard in fixing problems directly in <app>GStreamer</app> (instead of putting temporary workarounds 
inside <app>Pitivi</app>).</p>
-      </item>
      </list>
+     <note style="tip">
+         <p>To maximize <app>Pitivi</app>'s capabilities and reduce the possibilities of bugs, a very recent 
version of <app>GStreamer</app> is recommended. This is because <app>Pitivi</app> developers work hard on 
fixing problems directly in <app>GStreamer</app> instead of putting temporary workarounds inside 
<app>Pitivi</app>.</p>
+     </note>
 
     <section>
      <title>A word about editing-friendly codecs</title>
@@ -45,13 +47,15 @@
 
     <section>
      <title>The Good, the Bad and the Ugly</title>
-      <p><app>GStreamer</app> plugins come into three categories: good, bad and ugly. To maximize your 
experience, you may need to install some of all of these plugins to ensure compatibility with your media 
files. Whether or not you install them is up to you, and may depend on your country's jurisdiction regarding 
software patents.</p>
+      <p><app>GStreamer</app> plugins come into three categories: good, bad and ugly. You may need to 
install plugins from any category to ensure compatibility with your media files. Whether or not you install 
them is up to you, and may depend on your country's jurisdiction regarding software patents. An overview of 
gstreamer plugins and their classification into categories can be found on the <link 
href="http://gstreamer.freedesktop.org/documentation/plugins.html";>Gstreamer website</link>.</p>
         <list>
-            <item><p>The "Good" plugins are good quality plugins under the LGPL license. These plugins are 
considered safe and recommended at any time.</p></item>
-            <item><p>The "Bad" plugins are plugins whose code is not of good enough quality, or are not 
considered tested well enough. The licensing may or may not be LGPL.</p></item>
-            <item><p>The "Ugly" plugins are good quality plugins whose license is not LGPL or with licensing 
issues.</p></item>
+            <item><p>The "Good" plugins are high quality plugins under the LGPL license. These plugins are 
considered safe and recommended at any time. To install them, search for packages containing gstreamer 
plugins good in your distribution's repositories.</p></item>
+            <item><p>The "Bad" plugins are plugins whose code quality is not good enough, or are not 
considered tested well enough. The licensing may or may not be LGPL. To install them, search for packages 
containing gstreamer plugins bad in your distribution's repositories.</p></item>
+            <item><p>The "Ugly" plugins are good quality plugins whose license is not LGPL or with licensing 
issues. To install them, search for packages containing containing gstreamer plugins ugly in your 
distribution's repositories.</p></item>
         </list>
-      <note><p>In addition to the Good, Bad and Ugly plugins, you may want to install gstreamer-ffmpeg to 
have access to ffmpeg's set of codecs.</p></note>
+      <note style="tip">
+      <p>In addition to the Good, Bad and Ugly plugins, you may want to install the 
<em>gstreamer-ffmpeg</em> package to have access to ffmpeg's set of codecs.</p>
+      </note>
       <p></p>
     </section>