[blfs-book] r10463 - trunk/BOOK/multimedia/libdriv

krejzi at linuxfromscratch.org krejzi at linuxfromscratch.org
Tue Jul 24 09:16:21 PDT 2012


Author: krejzi
Date: 2012-07-24 10:16:08 -0600 (Tue, 24 Jul 2012)
New Revision: 10463

Modified:
   trunk/BOOK/multimedia/libdriv/alsa-utils.xml
   trunk/BOOK/multimedia/libdriv/farstream.xml
   trunk/BOOK/multimedia/libdriv/gst-ffmpeg.xml
   trunk/BOOK/multimedia/libdriv/gst-plugins-bad.xml
   trunk/BOOK/multimedia/libdriv/gst-plugins-base.xml
   trunk/BOOK/multimedia/libdriv/gst-plugins-good.xml
   trunk/BOOK/multimedia/libdriv/gst-plugins-ugly.xml
   trunk/BOOK/multimedia/libdriv/gstreamer.xml
   trunk/BOOK/multimedia/libdriv/libcanberra.xml
Log:
XML Polishing, Part 1. Review GStreamer pages.

Modified: trunk/BOOK/multimedia/libdriv/alsa-utils.xml
===================================================================
--- trunk/BOOK/multimedia/libdriv/alsa-utils.xml	2012-07-24 02:10:09 UTC (rev 10462)
+++ trunk/BOOK/multimedia/libdriv/alsa-utils.xml	2012-07-24 16:16:08 UTC (rev 10463)
@@ -95,7 +95,7 @@
     <para>Install <application>ALSA Utilities</application> by
     running the following commands:</para>
 
-<screen><userinput>./configure --with-systemdsystemunitdir=no &&
+<screen><userinput>./configure --without-systemdsystemunitdir &&
 make</userinput></screen>
 
     <para>This package does not come with a test suite.</para>
@@ -109,7 +109,7 @@
   <sect2 role="commands">
     <title>Command Explanations</title>
 
-    <para><command>--with-systemdsystemunitdir=no</command>:
+    <para><option>--without-systemdsystemunitdir</option>:
     Do not install systemd units.</para>
 
   </sect2>
@@ -163,19 +163,7 @@
       <para>The volume settings will be restored from the saved state by
       <application>Udev</application> when the device is detected (during boot
       or when plugged in for USB devices).</para>
-<!--
-      <para>As the <systemitem class="username">root</systemitem> user, install
-      a new <application>Udev</application> rules file to create the audio
-      device nodes and run the restore script:</para>
 
-<screen role="root"><userinput>cat > /etc/udev/rules.d/40-alsa.rules << "EOF"
-# /etc/udev/rules.d/40-alsa.rules
-
-# When a sound device is detected, restore the volume settings
-KERNEL=="controlC[0-9]*", ACTION=="add", RUN+="/usr/sbin/alsactl restore %n"
-EOF
-chmod -v 644 /etc/udev/rules.d/40-alsa.rules</userinput></screen>
--->
       <para>All sound devices are not accessible for any user except
       <systemitem class="username">root</systemitem> and members of the
       <systemitem class="groupname">audio</systemitem> group. Add any users
@@ -198,14 +186,12 @@
 
     <segmentedlist>
       <segtitle>Installed Programs</segtitle>
-      <segtitle>Installed Libraries</segtitle>
       <segtitle>Installed Directory</segtitle>
 
       <seglistitem>
         <seg>aconnect, alsaconf, alsactl, alsamixer, amidi,
         amixer, aplay, aplaymidi, arecord, arecordmidi, aseqdump,
         aseqnet, iecset, and speaker-test</seg>
-        <seg>None</seg>
         <seg>/var/lib/alsa and /usr/share/sounds/alsa</seg>
       </seglistitem>
     </segmentedlist>

Modified: trunk/BOOK/multimedia/libdriv/farstream.xml
===================================================================
--- trunk/BOOK/multimedia/libdriv/farstream.xml	2012-07-24 02:10:09 UTC (rev 10462)
+++ trunk/BOOK/multimedia/libdriv/farstream.xml	2012-07-24 16:16:08 UTC (rev 10463)
@@ -114,8 +114,9 @@
       commands:
     </para>
 
-<screen><userinput>./configure --prefix=/usr --disable-python \
-                               --disable-static &&
+<screen><userinput>./configure --prefix=/usr \
+            --disable-python \
+            --disable-static &&
 make</userinput></screen>
 
     <para>
@@ -157,7 +158,8 @@
           libfarstream-0.1.so
         </seg>
         <seg>
-          /usr/include/farstream-0.1, /usr/lib/farstream-0.1,
+          /usr/include/farstream-0.1,
+          /usr/lib/farstream-0.1,
           /usr/share/farstream,
           /usr/share/gtk-doc/html/farstream-libs-0.10 and
           /usr/share/gtk-doc/html/farstream-plugins-0.1
@@ -174,7 +176,7 @@
         <term><filename class="libraryfile">libfarstream-0.1.so</filename></term>
         <listitem>
           <para>
-            contains the Farstream API functions.
+            contains the <application>Farstream</application> API functions.
           </para>
           <indexterm zone="farstream libfarstream-0.1">
             <primary sortas="c-libfarstream-0.1">libfarstream-0.1.so</primary>

Modified: trunk/BOOK/multimedia/libdriv/gst-ffmpeg.xml
===================================================================
--- trunk/BOOK/multimedia/libdriv/gst-ffmpeg.xml	2012-07-24 02:10:09 UTC (rev 10462)
+++ trunk/BOOK/multimedia/libdriv/gst-ffmpeg.xml	2012-07-24 16:16:08 UTC (rev 10463)
@@ -27,32 +27,46 @@
   </indexterm>
 
   <sect2 role="package">
-    <title>Introduction to gst-ffmpeg</title>
+    <title>Introduction to Gst FFMpeg</title>
 
-    <para>The <application>gst-ffmpeg</application> package is a gstreamer plugin
-    for ffmpeg.</para>
+    <para>
+      The <application>Gst FFMpeg</application> contains GStreamer plugins
+      for <application>FFMpeg</application>.
+    </para>
 
-    &lfs70_checked;
+    &lfs71_checked;
 
     <bridgehead renderas="sect3">Package Information</bridgehead>
     <itemizedlist spacing="compact">
       <listitem>
-        <para>Download (HTTP): <ulink url="&gst-ffmpeg-download-http;"/></para>
+        <para>
+          Download (HTTP): <ulink url="&gst-ffmpeg-download-http;"/>
+        </para>
       </listitem>
       <listitem>
-        <para>Download (FTP): <ulink url="&gst-ffmpeg-download-ftp;"/></para>
+        <para>
+          Download (FTP): <ulink url="&gst-ffmpeg-download-ftp;"/>
+        </para>
       </listitem>
       <listitem>
-        <para>Download MD5 sum: &gst-ffmpeg-md5sum;</para>
+        <para>
+          Download MD5 sum: &gst-ffmpeg-md5sum;
+        </para>
       </listitem>
       <listitem>
-        <para>Download size: &gst-ffmpeg-size;</para>
+        <para>
+          Download size: &gst-ffmpeg-size;
+        </para>
       </listitem>
       <listitem>
-        <para>Estimated disk space required: &gst-ffmpeg-buildsize;</para>
+        <para>
+          Estimated disk space required: &gst-ffmpeg-buildsize;
+        </para>
       </listitem>
       <listitem>
-        <para>Estimated build time: &gst-ffmpeg-time;</para>
+        <para>
+          Estimated build time: &gst-ffmpeg-time;
+        </para>
       </listitem>
     </itemizedlist>
 
@@ -66,60 +80,57 @@
       </listitem>
     </itemizedlist>
 
-    <bridgehead renderas="sect3">gst-ffmpeg Dependencies</bridgehead>
+    <bridgehead renderas="sect3">Gst FFMpeg Dependencies</bridgehead>
 
     <bridgehead renderas="sect4">Required</bridgehead>
-    <para role="required"><xref linkend="gst-plugins-base"/> and
-    <xref linkend="yasm"/></para>
+    <para role="required">
+      <xref linkend="gst-plugins-base"/> and
+      <xref linkend="yasm"/>
+    </para>
 
     <bridgehead renderas="sect4">Optional</bridgehead>
-    <para role="optional"><ulink url="http://code.entropywave.com/projects/orc/">ORC
-    </ulink></para>
+    <para role="optional">
+      <ulink url="http://code.entropywave.com/projects/orc/">ORC</ulink>
+    </para>
 
     <para condition="html" role="usernotes">User Notes:
-    <ulink url="&blfs-wiki;/gst-ffmpeg"/></para>
-
+      <ulink url="&blfs-wiki;/gst-ffmpeg"/>
+    </para>
   </sect2>
 
   <sect2 role="installation">
-    <title>Installation of gst-ffmpeg</title>
+    <title>Installation of Gst FFMpeg</title>
 
-    <para>Install <application>gst-ffmpeg</application> by running the following
-    commands:</para>
+    <para>
+      Install <application>Gst FFMpeg</application> by running the following
+      commands:
+    </para>
 
 <screen><userinput>patch -p1 < ../gst-ffmpeg-&gst-ffmpeg-version;-gcc-4.7-1.patch &&
 ./configure --prefix=/usr &&
 make</userinput></screen>
 
-    <para>To test the results, issue: <command>make check</command>.</para>
+    <para>
+      To test the results, issue: <command>make check</command>.
+    </para>
 
-    <para>Now, as the <systemitem class="username">root</systemitem> user:</para>
+    <para>
+      Now, as the <systemitem class="username">root</systemitem> user:
+    </para>
 
 <screen role="root"><userinput>make install</userinput></screen>
   </sect2>
 
-  <sect2 role="commands">
-    <title>Command Explanations</title>
-
-    <para>
-      <command>patch -p1 <
-      ../gst-ffmpeg-&gst-ffmpeg-version;-gcc-4.7-1.patch</command>: This patch
-      fixes compiling Gst FFmpeg with Gcc 4.7.
-    </para>
-  </sect2>
-
   <sect2 role="content">
     <title>Contents</title>
 
     <segmentedlist>
-      <segtitle>Installed Programs</segtitle>
-      <segtitle>Installed Libraries</segtitle>
-      <segtitle>Installed Directory</segtitle>
+      <segtitle>Installed GStreamer Plugins</segtitle>
 
       <seglistitem>
-        <seg>None</seg>
-        <seg>libgstffmpeg.so, libgstffmpegscale.so, and libgstpostproc.so</seg>
-        <seg>None</seg>
+        <seg>
+          libgstffmpeg.so, libgstffmpegscale.so and libgstpostproc.so
+        </seg>
       </seglistitem>
     </segmentedlist>
 

Modified: trunk/BOOK/multimedia/libdriv/gst-plugins-bad.xml
===================================================================
--- trunk/BOOK/multimedia/libdriv/gst-plugins-bad.xml	2012-07-24 02:10:09 UTC (rev 10462)
+++ trunk/BOOK/multimedia/libdriv/gst-plugins-bad.xml	2012-07-24 16:16:08 UTC (rev 10463)
@@ -29,118 +29,146 @@
   <sect2 role="package">
     <title>Introduction to Gstreamer Bad Plug-ins</title>
 
-    <para>The <application>GStreamer Bad Plug-ins</application> package contains a
-    set a set of plug-ins that aren't up to par compared to the rest.  They might
-    be close to being good quality, but they're missing something - be it a good
-    code review, some documentation, a set of tests, a real live maintainer, or
-    some actual wide use.</para>
+    <para>
+      The <application>GStreamer Bad Plug-ins</application> package contains a set
+      a set of plug-ins that aren't up to par compared to the rest. They might be
+      close to being good quality, but they're missing something - be it a good
+      code review, some documentation, a set of tests, a real live maintainer,
+      or some actual wide use.  Also see the <xref linkend="gst-plugins-good"/>,
+      <xref linkend="gst-plugins-ugly"/> and <xref linkend="gst-ffmpeg"/> packages.
+    </para>
 
-    &lfs70_checked;
+    &lfs71_checked;
 
     <bridgehead renderas="sect3">Package Information</bridgehead>
     <itemizedlist spacing="compact">
       <listitem>
-        <para>Download (HTTP): <ulink url="&gst-plugins-bad-download-http;"/></para>
+        <para>
+          Download (HTTP): <ulink url="&gst-plugins-bad-download-http;"/>
+        </para>
       </listitem>
       <listitem>
-        <para>Download (FTP): <ulink url="&gst-plugins-bad-download-ftp;"/></para>
+        <para>
+          Download (FTP): <ulink url="&gst-plugins-bad-download-ftp;"/>
+        </para>
       </listitem>
       <listitem>
-        <para>Download MD5 sum: &gst-plugins-bad-md5sum;</para>
+        <para>
+          Download MD5 sum: &gst-plugins-bad-md5sum;
+        </para>
       </listitem>
       <listitem>
-        <para>Download size: &gst-plugins-bad-size;</para>
+        <para>
+          Download size: &gst-plugins-bad-size;
+        </para>
       </listitem>
       <listitem>
-        <para>Estimated disk space required: &gst-plugins-bad-buildsize;</para>
+        <para>
+          Estimated disk space required: &gst-plugins-bad-buildsize;
+        </para>
       </listitem>
       <listitem>
-        <para>Estimated build time: &gst-plugins-bad-time;</para>
+        <para>
+          Estimated build time: &gst-plugins-bad-time;
+        </para>
       </listitem>
     </itemizedlist>
 
     <bridgehead renderas="sect3">GStreamer Bad Plug-ins Dependencies</bridgehead>
 
     <bridgehead renderas="sect4">Required</bridgehead>
-    <para role="required"><xref linkend="gst-plugins-base"/></para>
+    <para role="required">
+      <xref linkend="gst-plugins-base"/>
+    </para>
 
+    <bridgehead renderas="sect4">Recommended</bridgehead>
+    <para role="recommended">
+      <xref linkend="faac"/>,
+      <xref linkend="libpng"/>,
+      <xref linkend="libvpx"/>,
+      <xref linkend="openssl"/> and
+      <xref linkend="xvid"/>
+    </para>
+
     <bridgehead renderas="sect4">Optional</bridgehead>
     <para role="optional">
-    <ulink url="http://www.celt-codec.org/">celt</ulink>,
-    <xref linkend="curl"/>,
-    <ulink url="http://diracvideo.org/">Dirac</ulink>,
-    <ulink url="http://www.directfb.org/">DirectFB</ulink>,
-    <xref linkend="faac"/>,
-    <xref linkend="faad2"/>,
-    <ulink url="http://www.speech.cs.cmu.edu/flite/">Flite</ulink>,
-    <ulink url="http://code.google.com/p/game-music-emu/">
-    Game Music Emu</ulink>,
-    <ulink url="http://libgsm.sourcearchive.com/">GSM</ulink>,
-    <xref linkend="jasper"/>,
-    <ulink url="http://www.ladspa.org/">LADSPA</ulink>,
-    <ulink url="http://code.google.com/p/libass/">libass</ulink>,
-    <ulink url="http://libcdaudio.sourceforge.net/">libcdaudio</ulink>,
-    <ulink url="http://sourceforge.net/projects/libdc1394">libdc1394</ulink>,
-    <ulink url="http://www.videolan.org/developers/libdca.html">libdca</ulink>,
-    <ulink url="http://libiptcdata.sourceforge.net/">libiptcdata</ulink>,
-    <ulink url="http://code.google.com/p/libkate/">libkate</ulink>,
-    <ulink url="http://sourceforge.net/projects/farsight/files/libmimic/">
-    libmimic</ulink>,
-    <ulink url="http://sourceforge.net/projects/libmms">libmms</ulink>,
-    <ulink url="http://sourceforge.net/projects/modplug-xmms/">libmodplug</ulink>,
-    <ulink url="http://www.musepack.net/">libmpcdec</ulink>,
-    <xref linkend="libmusicbrainz"/>,
-    <ulink url="http://code.google.com/p/musicip-libofa/">libofa</ulink>,
-    <xref linkend="libpng"/>,
-    <xref linkend="librsvg"/>,
-    <xref linkend="libsndfile"/>,
-    <xref linkend="libtheora"/>,
-    <ulink url="http://cgit.freedesktop.org/~aplattner/libvdpau">
-    libvdpau</ulink>,
-    <xref linkend="libvpx"/>,
-    <ulink url="http://mjpeg.sourceforge.net/">MJPEG Tools</ulink>,
-    <xref linkend="neon"/>,
-    <ulink url="http://kcat.strangesoft.net/openal.html">OpenAL</ulink>,
-    <xref linkend="openssl"/>,
-    <ulink url="http://code.entropywave.com/projects/orc/">ORC</ulink>,
-    <ulink url="http://rtmpdump.mplayerhq.hu/">rtmpdump</ulink>,
-    <ulink url="http://diracvideo.org/">Schroedinger</ulink>,
-    <xref linkend="sdl"/>,
-    <ulink url="http://www.surina.net/soundtouch/">SoundTouch</ulink>,
-    <ulink url="http://www.soft-switch.org/">SpanDSP</ulink>,
-    <ulink url="http://sourceforge.net/projects/opencore-amr/">
-    vo-aacenc</ulink>,
-    <ulink url="http://sourceforge.net/projects/opencore-amr/">
-    vo-amrwbenc</ulink>,
-    <ulink url="http://wildmidi.sourceforge.net/">WildMidi</ulink>,
-    <xref linkend="xvid"/>,
-    <ulink url="http://zbar.sourceforge.net/">ZBAR</ulink>,
-    <ulink url="http://zapping.sourceforge.net/ZVBI/index.html">
-    ZVBI</ulink></para>
+      <ulink url="http://www.celt-codec.org/">celt</ulink>,
+      <xref linkend="curl"/>,
+      <ulink url="http://diracvideo.org/">Dirac</ulink>,
+      <ulink url="http://www.directfb.org/">DirectFB</ulink>,
+      <xref linkend="faac"/>,
+      <xref linkend="faad2"/>,
+      <ulink url="http://www.speech.cs.cmu.edu/flite/">Flite</ulink>,
+      <ulink url="http://code.google.com/p/game-music-emu/">
+      Game Music Emu</ulink>,
+      <ulink url="http://libgsm.sourcearchive.com/">GSM</ulink>,
+      <xref linkend="jasper"/>,
+      <ulink url="http://www.ladspa.org/">LADSPA</ulink>,
+      <ulink url="http://code.google.com/p/libass/">libass</ulink>,
+      <ulink url="http://libcdaudio.sourceforge.net/">libcdaudio</ulink>,
+      <ulink url="http://sourceforge.net/projects/libdc1394">libdc1394</ulink>,
+      <ulink url="http://www.videolan.org/developers/libdca.html">libdca</ulink>,
+      <ulink url="http://libiptcdata.sourceforge.net/">libiptcdata</ulink>,
+      <ulink url="http://code.google.com/p/libkate/">libkate</ulink>,
+      <ulink url="http://sourceforge.net/projects/farsight/files/libmimic/">
+      libmimic</ulink>,
+      <ulink url="http://sourceforge.net/projects/libmms">libmms</ulink>,
+      <ulink url="http://sourceforge.net/projects/modplug-xmms/">libmodplug</ulink>,
+      <ulink url="http://www.musepack.net/">libmpcdec</ulink>,
+      <xref linkend="libmusicbrainz"/>,
+      <ulink url="http://code.google.com/p/musicip-libofa/">libofa</ulink>,
+      <xref linkend="librsvg"/>,
+      <xref linkend="libsndfile"/>,
+      <ulink url="http://cgit.freedesktop.org/~aplattner/libvdpau">
+      libvdpau</ulink>,
+      <ulink url="http://mjpeg.sourceforge.net/">MJPEG Tools</ulink>,
+      <xref linkend="neon"/>,
+      <ulink url="http://kcat.strangesoft.net/openal.html">OpenAL</ulink>,
+      <ulink url="http://code.entropywave.com/projects/orc/">ORC</ulink>,
+      <ulink url="http://rtmpdump.mplayerhq.hu/">rtmpdump</ulink>,
+      <ulink url="http://diracvideo.org/">Schroedinger</ulink>,
+      <xref linkend="sdl"/>,
+      <ulink url="http://www.surina.net/soundtouch/">SoundTouch</ulink>,
+      <ulink url="http://www.soft-switch.org/">SpanDSP</ulink>,
+      <ulink url="http://sourceforge.net/projects/opencore-amr/">
+      VO AACENC</ulink>,
+      <ulink url="http://sourceforge.net/projects/opencore-amr/">
+      VO AMRWBENC</ulink>,
+      <ulink url="http://wildmidi.sourceforge.net/">WildMidi</ulink>,
+      <ulink url="http://zbar.sourceforge.net/">ZBAR</ulink> and
+      <ulink url="http://zapping.sourceforge.net/ZVBI/index.html">
+      ZVBI</ulink>
+    </para>
 
     <bridgehead renderas="sect4">Optional, for the unit regression tests</bridgehead>
-    <para>To run the tests you need to have compiled gstreamer against libcheck,
-    and you can optionally use
-    <ulink url="http://www.valgrind.org/">Valgrind</ulink></para>
+    <para>
+      <ulink url="http://www.valgrind.org/">Valgrind</ulink>
+    </para>
 
     <para condition="html" role="usernotes">User Notes:
-    <ulink url="&blfs-wiki;/gst-plugins-bad"/></para>
-
+      <ulink url="&blfs-wiki;/gst-plugins-bad"/>
+    </para>
   </sect2>
 
   <sect2 role="installation">
     <title>Installation of GStreamer Bad Plug-ins</title>
 
-    <para>Install <application>Gstreamer Bad Plug-ins</application> by running the following
-    commands:</para>
+    <para>
+      Install <application>Gstreamer Bad Plug-ins</application> by running the following
+      commands:
+    </para>
 
 <screen><userinput>./configure --prefix=/usr --with-gtk=3.0 --disable-examples &&
 make</userinput></screen>
 
-    <para>To test the results, issue: <command>make check</command>. Note that
-    tests for some of the items may fail.</para>
+    <para>
+      To test the results, issue: <command>make check</command>. Note that
+      tests for some of the items may fail.
+    </para>
 
-    <para>Now, as the <systemitem class="username">root</systemitem> user:</para>
+    <para>
+      Now, as the <systemitem class="username">root</systemitem> user:
+    </para>
 
 <screen role="root"><userinput>make install</userinput></screen>
 
@@ -149,12 +177,16 @@
   <sect2 role="commands">
     <title>Command Explanations</title>
 
-    <para><command>--with-gtk=3.0</command>: Build with <application>gtk3</application>
-    instead of the default gtk2 : recommended for a <application>gnome</application>
-    desktop.</para>
+    <para>
+      <parameter>--with-gtk=3.0</parameter>: Build against <application>GTK+ 3</application>
+      instead of the default <application>GTK+ 2</application>: recommended for a
+      <application>GNOME</application> Desktop.
+    </para>
 
-    <para><command>--disable-examples</command>: if the dependenc{y,ies} for the camera
-    driver have been satisfied, the associated example code fails to build.</para>
+    <para>
+      <option>--disable-examples</option>: if the dependencies for the camera
+      driver have been satisfied, the associated example code fails to build.
+    </para>
 
   </sect2>
 
@@ -162,16 +194,19 @@
     <title>Contents</title>
 
     <segmentedlist>
-      <segtitle>Installed Programs</segtitle>
       <segtitle>Installed Libraries</segtitle>
       <segtitle>Installed Directories</segtitle>
 
       <seglistitem>
-        <seg>none</seg>
-        <seg>Several <application>GStreamer</application> plugins</seg>
-        <seg>/usr/{include/gstreamer-0.10/gst/signalprocessor,
-        share/{gtk-doc/gst-plugins-bad-libs-0.10,
-        gstreamer-0.10/camera-apps}}</seg>
+        <seg>
+          libgstbasecamerabinsrc-0.10.so, libgstbasevideo-0.10.so, libgstcodecparsers-0.10.so,
+          libgstphotography-0.10.so, libgstsignalprocessor-0.10.so and libgstvdp-0.10.so
+        </seg>
+        <seg>
+          /usr/include/gstreamer-0.10/gst/{basecamerabinsrc,codecparsers,interfaces},
+          /usr/include/gstreamer-0.10/gst/{signalprocessor,vdpau,video} and
+          /usr/share/gtk-doc/gst-plugins-bad-libs-0.10
+        </seg>
       </seglistitem>
     </segmentedlist>
 

Modified: trunk/BOOK/multimedia/libdriv/gst-plugins-base.xml
===================================================================
--- trunk/BOOK/multimedia/libdriv/gst-plugins-base.xml	2012-07-24 02:10:09 UTC (rev 10462)
+++ trunk/BOOK/multimedia/libdriv/gst-plugins-base.xml	2012-07-24 16:16:08 UTC (rev 10463)
@@ -30,38 +30,52 @@
   <sect2 role="package">
     <title>Introduction to GStreamer Base Plug-ins</title>
 
-    <para>The <application>GStreamer Base Plug-ins</application> is a
-    well-groomed and well-maintained collection of
-    <application>GStreamer</application> plug-ins and elements, spanning the
-    range of possible types of elements one would want to write for
-    <application>GStreamer</application>. It also contains helper libraries
-    and base classes useful for writing elements. A wide range of video and
-    audio decoders, encoders, and filters are included. Also see the
-    <xref linkend="gst-plugins-good"/>, <xref linkend="gst-plugins-bad"/>,
-    <xref linkend="gst-plugins-ugly"/>, and <xref linkend="gst-ffmpeg"/>
-    packages.</para>
+    <para>
+      The <application>GStreamer Base Plug-ins</application> is a
+      well-groomed and well-maintained collection of
+      <application>GStreamer</application> plug-ins and elements, spanning the
+      range of possible types of elements one would want to write for
+      <application>GStreamer</application>. It also contains helper libraries
+      and base classes useful for writing elements. A wide range of video and
+      audio decoders, encoders, and filters are included. Also see the
+      <xref linkend="gst-plugins-bad"/>, <xref linkend="gst-plugins-good"/>,
+      <xref linkend="gst-plugins-ugly"/>, and <xref linkend="gst-ffmpeg"/>
+      packages.
+    </para>
 
-    &lfs70_checked;
+    &lfs71_checked;
 
     <bridgehead renderas="sect3">Package Information</bridgehead>
     <itemizedlist spacing="compact">
       <listitem>
-        <para>Download (HTTP): <ulink url="&gst-plugins-base-download-http;"/></para>
+        <para>
+          Download (HTTP): <ulink url="&gst-plugins-base-download-http;"/>
+        </para>
       </listitem>
       <listitem>
-        <para>Download (FTP): <ulink url="&gst-plugins-base-download-ftp;"/></para>
+        <para>
+          Download (FTP): <ulink url="&gst-plugins-base-download-ftp;"/>
+        </para>
       </listitem>
       <listitem>
-        <para>Download MD5 sum: &gst-plugins-base-md5sum;</para>
+        <para>
+          Download MD5 sum: &gst-plugins-base-md5sum;
+        </para>
       </listitem>
       <listitem>
-        <para>Download size: &gst-plugins-base-size;</para>
+        <para>
+          Download size: &gst-plugins-base-size;
+        </para>
       </listitem>
       <listitem>
-        <para>Estimated disk space required: &gst-plugins-base-buildsize;</para>
+        <para>
+          Estimated disk space required: &gst-plugins-base-buildsize;
+        </para>
       </listitem>
       <listitem>
-        <para>Estimated build time: &gst-plugins-base-time;</para>
+        <para>
+          Estimated build time: &gst-plugins-base-time;
+        </para>
       </listitem>
     </itemizedlist>
 
@@ -108,61 +122,57 @@
     </para>
 
     <para condition="html" role="usernotes">User Notes:
-    <ulink url="&blfs-wiki;/gst-plugins-base"/></para>
-
+      <ulink url="&blfs-wiki;/gst-plugins-base"/>
+    </para>
   </sect2>
 
   <sect2 role="installation">
     <title>Installation of GStreamer Base Plug-ins</title>
 
-    <para>Install <application>GStreamer Base Plug-ins</application> by running
-    the following commands:</para>
+    <para>
+      Install <application>GStreamer Base Plug-ins</application> by running
+      the following commands:
+    </para>
 
 <screen><userinput>sed -i 's/\(.*gtkdoc-rebase --relative.* \)\(;.*\)/\1|| true\2/' \
   docs/libs/Makefile.in &&
 ./configure --prefix=/usr &&
 make</userinput></screen>
 
-    <!-- without libcheck, 'make check' is pointless -->
-    <para>To run the unit regression tests, issue: <command>make check</command>.
-    There are
-    many other <filename>Makefile</filename> targets you can specify for
-    running the tests, issue <command>make -C tests/check help</command> to see
-    the complete list.</para>
+    <para>
+      To run the unit regression tests, issue: <command>make check</command>.
+      There are many other <filename>Makefile</filename> targets you can specify
+      for running the tests, issue <command>make -C tests/check help</command>
+      to see the complete list.
+    </para>
 
-    <para>Now, as the <systemitem class="username">root</systemitem> user:</para>
+    <para>
+      Now, as the <systemitem class="username">root</systemitem> user:
+    </para>
 
 <screen role="root"><userinput>make install</userinput></screen>
 
-    <!-- Docs are installed now
-    <para>If you did not rebuild the API documentation by passing
-    <option>-enable-gtk-doc</option> to the <command>configure</command>
-    script and you wish to install the pre-built documentation, issue the
-    following command as the <systemitem class="username">root</systemitem>
-    user:</para>
-
-<screen role="root"><userinput>make -C docs/libs install-data &&
-make -C docs/plugins install-data</userinput></screen>-->
-
   </sect2>
 
   <sect2 role="commands">
     <title>Command Explanations</title>
 
+    <para>
+      <command>sed -i 's/\(.*gtkdoc-rebase --relative.* \)\(;.*\)/\1|| true\2/' \
+      docs/libs/Makefile.in</command>: This <command>sed</command> tests if
+      <command>gtkdoc-rebase</command> is present, and only uses it if it is,
+      but the test <command>which gtk-doc</command> is interpreted as an error by
+      <command>make</command> if <command>gtkdoc-rebase</command> is not present.
+      The <command>sed</command> command ensures the command is always regarded as
+      successful.
+    </para>
+
     <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
-    href="../../xincludes/gtk-doc-rebuild.xml"/>
+      href="../../xincludes/static-libraries.xml"/>
 
-    <para><option>sed -i 's/\(.*gtkdoc-rebase --relative.* \)\(;.*\)/\1|| true\2/' \
-    docs/libs/Makefile.in</option>: This Makefile tests if
-    <command>gtkdoc-rebase</command> is present, and only uses it if it is,
-    but the test <command>which gtk-doc</command> is interpreted as an error by
-    <command>make</command> if <command>gtkdoc-rebase</command> is not present.  The
-    <command>sed</command> command ensures the command is always regarded as
-    successful.</para>
+    <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
+      href="../../xincludes/gtk-doc-rebuild.xml"/>
 
-    <para><option>--disable-static</option>: This switch prevents the static
-    libraries from being built.</para>
-
   </sect2>
 
   <sect2 role="content">
@@ -174,11 +184,22 @@
       <segtitle>Installed Directories</segtitle>
 
       <seglistitem>
-        <seg>gst-visualise-0.10</seg>
-        <seg>libgst*.{so,a} and numerous <application>GStreamer</application>
-        plugins</seg>
-        <seg>/usr/include/gstreamer-0.10/gst/{too numerous to list} and
-        /usr/share/gtk-doc/html/gst-plugins-base-libs-0.10</seg>
+        <seg>
+          gst-visualise-0.10
+        </seg>
+        <seg>
+          libgstapp-0.10.so, libgstaudio-0.10.so, libgstcdda-0.10.so, libgstfft-0.10.so,
+          libgstinterfaces-0.10.so, libgstnetbuffer-0.10.so, libgstpbutils-0.10.so,
+          libgstriff-0.10.so, libgstrtp-0.10.so, libgstrtsp-0.10.so, libgstsdp-0.10.so,
+          libgsttag-0.10.so and libgstvideo-0.10.so
+        </seg>
+        <seg>
+          /usr/include/gstreamer-0.10/gst/{app,audio,cdda,fft,floatcast,interfaces,netbuffer}
+          /usr/include/gstreamer-0.10/gst/{pbutils,riff,rtp,rtsp,sdp,tag,video},
+          /usr/share/gst-plugins-base,
+          /usr/share/gtk-doc/html/gst-plugins-base-libs-0.10 and
+          /usr/share/gtk-doc/html/gst-plugins-base-plugins-0.10
+        </seg>
       </seglistitem>
     </segmentedlist>
 
@@ -190,8 +211,10 @@
       <varlistentry id="gst-visualise">
         <term><command>gst-visualise-0.10</command></term>
         <listitem>
-          <para>is used to run a basic <application>GStreamer</application>
-          pipeline to display a graphical visualisation of an audio stream.</para>
+          <para>
+            is used to run a basic <application>GStreamer</application>
+            pipeline to display a graphical visualisation of an audio stream.
+          </para>
           <indexterm zone="gst-plugins-base gst-visualise">
             <primary sortas="b-gst-visualise">gst-visualise-0.10</primary>
           </indexterm>

Modified: trunk/BOOK/multimedia/libdriv/gst-plugins-good.xml
===================================================================
--- trunk/BOOK/multimedia/libdriv/gst-plugins-good.xml	2012-07-24 02:10:09 UTC (rev 10462)
+++ trunk/BOOK/multimedia/libdriv/gst-plugins-good.xml	2012-07-24 16:16:08 UTC (rev 10463)
@@ -5,17 +5,16 @@
   %general-entities;
 
   <!ENTITY gst-plugins-good-download-http
-    "&gnome-download-http;/gst-plugins-good/0.10/gst-plugins-good-&gst-plugins-good-version;.tar.xz">
+          "&gnome-download-http;/gst-plugins-good/0.10/gst-plugins-good-&gst-plugins-good-version;.tar.xz">
   <!ENTITY gst-plugins-good-download-ftp
-    "&gnome-download-ftp;/gst-plugins-good/0.10/gst-plugins-good-&gst-plugins-good-version;.tar.xz">
+           "&gnome-download-ftp;/gst-plugins-good/0.10/gst-plugins-good-&gst-plugins-good-version;.tar.xz">
   <!ENTITY gst-plugins-good-md5sum        "555845ceab722e517040bab57f9ace95">
   <!ENTITY gst-plugins-good-size          "2.6 MB">
   <!ENTITY gst-plugins-good-buildsize     "110 MB">
   <!ENTITY gst-plugins-good-time          "1.2 SBU">
 ]>
 
-<sect1 id="gst-plugins-good"
-       xreflabel="gst-plugins-good-&gst-plugins-good-version;">
+<sect1 id="gst-plugins-good" xreflabel="gst-plugins-good-&gst-plugins-good-version;">
   <?dbhtml filename="gst-plugins-good.html"?>
 
   <sect1info>
@@ -124,8 +123,6 @@
 
     <bridgehead renderas="sect4">Optional, for the unit regression tests</bridgehead>
     <para>
-      To run the tests you need to have compiled gstreamer against libcheck, and
-      you can optionally use
       <ulink url="http://www.valgrind.org/">Valgrind</ulink>
     </para>
 
@@ -192,14 +189,10 @@
     <title>Contents</title>
 
     <segmentedlist>
-      <segtitle>Installed Libraries</segtitle>
       <segtitle>Installed Directory</segtitle>
 
       <seglistitem>
         <seg>
-          Numerous <application>GStreamer</application> plugins
-        </seg>
-        <seg>
           /usr/share/gtk-doc/html/gst-plugins-good-plugins-0.10
         </seg>
       </seglistitem>

Modified: trunk/BOOK/multimedia/libdriv/gst-plugins-ugly.xml
===================================================================
--- trunk/BOOK/multimedia/libdriv/gst-plugins-ugly.xml	2012-07-24 02:10:09 UTC (rev 10462)
+++ trunk/BOOK/multimedia/libdriv/gst-plugins-ugly.xml	2012-07-24 16:16:08 UTC (rev 10463)
@@ -4,17 +4,16 @@
   <!ENTITY % general-entities SYSTEM "../../general.ent">
   %general-entities;
 
-  <!ENTITY gst-plugins-ugly-download-http "http://gstreamer.freedesktop.org/src/gst-plugins-ugly/gst-plugins-ugly-&gst-plugins-ugly-version;.tar.xz">
+  <!ENTITY gst-plugins-ugly-download-http 
+           "http://gstreamer.freedesktop.org/src/gst-plugins-ugly/gst-plugins-ugly-&gst-plugins-ugly-version;.tar.xz">
   <!ENTITY gst-plugins-ugly-download-ftp  " ">
-  <!-- <!ENTITY gst-plugins-ugly-download-ftp  "&gnome-download-ftp;/gst-plugins-ugly/0.10/gst-plugins-ugly-&gst-plugins-ugly-version;.tar.bz2"> -->
   <!ENTITY gst-plugins-ugly-md5sum        "ba26045c8c8c91f0d48d327ccf53ac0c">
   <!ENTITY gst-plugins-ugly-size          "864 KB">
   <!ENTITY gst-plugins-ugly-buildsize     "20 MB">
   <!ENTITY gst-plugins-ugly-time          "0.3 SBU">
 ]>
 
-<sect1 id="gst-plugins-ugly"
-       xreflabel="gst-plugins-ugly-&gst-plugins-ugly-version;">
+<sect1 id="gst-plugins-ugly" xreflabel="gst-plugins-ugly-&gst-plugins-ugly-version;">
   <?dbhtml filename="gst-plugins-ugly.html"?>
 
   <sect1info>
@@ -31,39 +30,50 @@
   <sect2 role="package">
     <title>Introduction to GStreamer Ugly Plug-ins</title>
 
-    <para>The <application>GStreamer Ugly Plug-ins</application> is a set of
-    plug-ins considered by the <application>GStreamer</application> developers
-    to have good quality and correct functionality, but distributing them might
-    pose problems. The license on either the plug-ins or the supporting
-    libraries might not be how the <application>GStreamer</application>
-    developers would like. The code might be widely known to present patent
-    problems. Also see the <xref linkend="gst-plugins-good"/>, <ulink
-    url="http://gstreamer.freedesktop.org/modules/gst-plugins-bad.html">
-    GStreamer Bad Plug-ins</ulink> and <ulink
-    url="http://gstreamer.freedesktop.org/modules/gst-ffmpeg.html">GStreamer
-    FFmpeg plug-in</ulink> packages.</para>
+    <para>
+      The <application>GStreamer Ugly Plug-ins</application> is a set of plug-ins
+      considered by the <application>GStreamer</application> developers  to have
+      good quality and correct functionality, but distributing them might pose
+      problems. The license on either the plug-ins or the supporting libraries
+      might not be how the <application>GStreamer</application> developers would
+      like. The code might be widely known to present patent problems. Also see
+      the <xref linkend="gst-plugins-bad"/>, <xref linkend="gst-plugins-good"/>
+      and <xref linkend="gst-ffmpeg"/> packages.
+    </para>
 
-    &lfs70_checked;
+    &lfs71_checked;
 
     <bridgehead renderas="sect3">Package Information</bridgehead>
     <itemizedlist spacing="compact">
       <listitem>
-        <para>Download (HTTP): <ulink url="&gst-plugins-ugly-download-http;"/></para>
+        <para>
+          Download (HTTP): <ulink url="&gst-plugins-ugly-download-http;"/>
+        </para>
       </listitem>
       <listitem>
-        <para>Download (FTP): <ulink url="&gst-plugins-ugly-download-ftp;"/></para>
+        <para>
+          Download (FTP): <ulink url="&gst-plugins-ugly-download-ftp;"/>
+        </para>
       </listitem>
       <listitem>
-        <para>Download MD5 sum: &gst-plugins-ugly-md5sum;</para>
+        <para>
+          Download MD5 sum: &gst-plugins-ugly-md5sum;
+        </para>
       </listitem>
       <listitem>
-        <para>Download size: &gst-plugins-ugly-size;</para>
+        <para>
+          Download size: &gst-plugins-ugly-size;
+        </para>
       </listitem>
       <listitem>
-        <para>Estimated disk space required: &gst-plugins-ugly-buildsize;</para>
+        <para>
+          Estimated disk space required: &gst-plugins-ugly-buildsize;
+        </para>
       </listitem>
       <listitem>
-        <para>Estimated build time: &gst-plugins-ugly-time;</para>
+        <para>
+          Estimated build time: &gst-plugins-ugly-time;
+        </para>
       </listitem>
     </itemizedlist>
 
@@ -98,13 +108,12 @@
 
     <bridgehead renderas="sect4">Optional, for the unit regression tests</bridgehead>
     <para>
-      To run the tests you need to have compiled gstreamer against libcheck,
-      and you can optionaly use
       <ulink url="http://www.valgrind.org/">Valgrind</ulink>
     </para>
 
-    <bridgehead renderas="sect4">Optional (Required to Rebuild the API
-    Documentation)</bridgehead>
+    <bridgehead renderas="sect4">
+      Optional (Required to Rebuild the API Documentation)
+    </bridgehead>
     <para role="optional">
       <xref linkend="gtk-doc"/> and
       <xref linkend="python2"/> (compiled against an XML parser such as
@@ -112,47 +121,61 @@
     </para>
 
     <para condition="html" role="usernotes">User Notes:
-    <ulink url="&blfs-wiki;/gst-plugins-ugly"/></para>
-
+      <ulink url="&blfs-wiki;/gst-plugins-ugly"/>
+    </para>
   </sect2>
 
   <sect2 role="installation">
     <title>Installation of GStreamer Ugly Plug-ins</title>
 
-    <para>Install <application>GStreamer Ugly Plug-ins</application> by running
-    the following commands:</para>
+    <para>
+      Install <application>GStreamer Ugly Plug-ins</application> by running
+      the following commands:
+    </para>
 
 <screen><userinput>./configure --prefix=/usr &&
 make</userinput></screen>
 
-    <para>To run the unit regression tests, issue: <command>make check</command>.</para>
+    <para>
+      To run the unit regression tests, issue: <command>make check</command>.
+    </para>
 
-    <para>Now, as the <systemitem class="username">root</systemitem> user:</para>
+    <para>
+      Now, as the <systemitem class="username">root</systemitem> user:
+    </para>
 
 <screen role="root"><userinput>make install</userinput></screen>
 
-    <para>If you did not rebuild the API documentation by passing
-    <option>--enable-gtk-doc</option> to the <command>configure</command>
-    script and you wish to install the pre-built documentation, issue the
-    following command as the <systemitem class="username">root</systemitem>
-    user:</para>
+    <para>
+      If you did not rebuild the API documentation by passing
+      <option>--enable-gtk-doc</option> to the <command>configure</command>
+      script and you wish to install the pre-built documentation, issue the
+      following command as the <systemitem class="username">root</systemitem>
+      user:
+    </para>
 
 <screen role="root"><userinput>make -C docs/plugins install-data</userinput></screen>
 
   </sect2>
 
+  <sect2 role="commands">
+    <title>Command Explanations</title>
+
+    <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
+      href="../../xincludes/gtk-doc-rebuild.xml"/>
+
+  </sect2>
+
   <sect2 role="content">
     <title>Contents</title>
 
     <segmentedlist>
-      <segtitle>Installed Programs</segtitle>
-      <segtitle>Installed Libraries</segtitle>
-      <segtitle>Installed Directories</segtitle>
+      <segtitle>Installed Directory</segtitle>
 
       <seglistitem>
-        <seg>None</seg>
-        <seg>Several <application>GStreamer</application> plugins</seg>
-        <seg>/usr/share/gtk-doc/html/gst-plugins-ugly-plugins-0.10</seg>
+        <seg>
+          /usr/share/gtk-doc/html/gst-plugins-ugly-plugins-0.10
+        </seg>
       </seglistitem>
     </segmentedlist>
 

Modified: trunk/BOOK/multimedia/libdriv/gstreamer.xml
===================================================================
--- trunk/BOOK/multimedia/libdriv/gstreamer.xml	2012-07-24 02:10:09 UTC (rev 10462)
+++ trunk/BOOK/multimedia/libdriv/gstreamer.xml	2012-07-24 16:16:08 UTC (rev 10463)
@@ -12,7 +12,7 @@
   <!ENTITY gstreamer-time          "1.2 SBU">
 ]>
 
-<sect1 id="gstreamer" xreflabel="gstreamer-&gstreamer-version;">
+<sect1 id="gstreamer" xreflabel="GStreamer-&gstreamer-version;">
   <?dbhtml filename="gstreamer.html"?>
 
   <sect1info>
@@ -20,7 +20,7 @@
     <date>$Date$</date>
   </sect1info>
 
-  <title>gstreamer-&gstreamer-version;</title>
+  <title>GStreamer-&gstreamer-version;</title>
 
   <indexterm zone="gstreamer">
     <primary sortas="a-GStreamer">GStreamer</primary>
@@ -29,38 +29,52 @@
   <sect2 role="package">
     <title>Introduction to GStreamer</title>
 
-    <para>The <application>GStreamer</application> package contains a streaming
-    media framework that enables applications to share a common set of plugins for
-    things like video decoding and encoding, audio encoding and decoding, audio
-    and video filters, audio visualisation, Web streaming and anything else that
-    streams in real-time or otherwise. It is modelled after research software
-    worked on at the Oregon Graduate Institute. After installing
-    <application>GStreamer</application>, you'll likely need to install
-    one or more of the <xref linkend="gst-plugins-good"/>,
-    <xref linkend="gst-plugins-ugly"/>, <xref linkend="gst-plugins-bad"/>
-    and <xref linkend="gst-ffmpeg"/> packages.</para>
+    <para>
+      <application>GStreamer</application> is a streaming media framework that
+      enables applications to share a common set of plugins for things like
+      video decoding and encoding, audio encoding and decoding, audio and video
+      filters, audio visualisation, Web streaming and anything else that streams
+      in real-time or otherwise. It is modelled after research software worked
+      on at the Oregon Graduate Institute. After installing
+      <application>GStreamer</application>, you'll likely need to install one or
+      more of the <xref linkend="gst-plugins-bad"/>,
+      <xref linkend="gst-plugins-good"/>, <xref linkend="gst-plugins-ugly"/> and
+      <xref linkend="gst-ffmpeg"/> packages.
+    </para>
 
-    &lfs70_checked;
+    &lfs71_checked;
 
     <bridgehead renderas="sect3">Package Information</bridgehead>
     <itemizedlist spacing="compact">
       <listitem>
-        <para>Download (HTTP): <ulink url="&gstreamer-download-http;"/></para>
+        <para>
+          Download (HTTP): <ulink url="&gstreamer-download-http;"/>
+        </para>
       </listitem>
       <listitem>
-        <para>Download (FTP): <ulink url="&gstreamer-download-ftp;"/></para>
+        <para>
+          Download (FTP): <ulink url="&gstreamer-download-ftp;"/>
+        </para>
       </listitem>
       <listitem>
-        <para>Download MD5 sum: &gstreamer-md5sum;</para>
+        <para>
+          Download MD5 sum: &gstreamer-md5sum;
+        </para>
       </listitem>
       <listitem>
-        <para>Download size: &gstreamer-size;</para>
+        <para>
+          Download size: &gstreamer-size;
+        </para>
       </listitem>
       <listitem>
-        <para>Estimated disk space required: &gstreamer-buildsize;</para>
+        <para>
+          Estimated disk space required: &gstreamer-buildsize;
+        </para>
       </listitem>
       <listitem>
-        <para>Estimated build time: &gstreamer-time;</para>
+        <para>
+          Estimated build time: &gstreamer-time;
+        </para>
       </listitem>
     </itemizedlist>
 
@@ -80,64 +94,57 @@
     <bridgehead renderas="sect4">Optional</bridgehead>
     <para role="optional">
       <xref linkend="gsl"/>,
-      <xref linkend='check'/> (required to run the unit regression tests and also enables
-      <filename class='libraryfile'>libgstcheck-0.10</filename>), and
       <ulink url="http://www.valgrind.org/">Valgrind</ulink>
       (optionaly used during the unit regression tests)
     </para>
 
-    <!-- exceptionally, there seems no way to install the shipped
-    API docs, so they have to be built, not rebuilt.-->
-    <bridgehead renderas="sect4">Optional (Required to build the API
-    Documentation)</bridgehead>
+    <bridgehead renderas="sect4">
+      Optional (Required to rebuild the API Documentation)
+    </bridgehead>
     <para role="optional">
       <xref linkend="gtk-doc"/> and
       <xref linkend="python2"/> (compiled against an XML Parser such as
-      <xref linkend="expat"/>).  Alternatively, developers can access
-      the online API docs at <ulink
-      url="http://gstreamer.freedesktop.org/data/doc/gstreamer/head/gstreamer/html/api-index-full.html">
-      freedesktop.org</ulink>
+      <xref linkend="expat"/>).
     </para>
 
-    <bridgehead renderas="sect4">Optional (Required to Build
-    Manuals)</bridgehead>
+    <bridgehead renderas="sect4">Optional (Required to Build Manuals)</bridgehead>
     <para role="optional">
-      <xref linkend="libxslt"/>,
-      <xref linkend="texlive"/>,
       <xref linkend="docbook-utils"/>,
-      <ulink url="http://www.xfig.org/">Transfig</ulink> (all needed
-      to build the HTML manual), plus
-      <xref linkend="gs"/>, and
-      <ulink url="http://netpbm.sourceforge.net/">Netpbm</ulink>
-      to build the postscript and PDF manuals.
-      Alternatively, developers can access the online manual at <ulink
-      url="http://gstreamer.freedesktop.org/data/doc/gstreamer/head/manual/html/index.html">
-      freedesktop.org</ulink>
+      <xref linkend="gs"/>
+      <xref linkend="libxslt"/> and
+      <xref linkend="texlive"/>
     </para>
 
     <para condition="html" role="usernotes">User Notes:
-    <ulink url="&blfs-wiki;/gstreamer"/></para>
-
+      <ulink url="&blfs-wiki;/gstreamer"/>
+    </para>
   </sect2>
 
   <sect2 role="installation">
     <title>Installation of GStreamer</title>
 
-    <para>Install <application>GStreamer</application> by running the following
-    commands:</para>
+    <para>
+      Install <application>GStreamer</application> by running the following
+      commands:
+    </para>
 
 <screen><userinput>sed -i 's/\(.*gtkdoc-rebase --relative.* \)\(;.*\)/\1|| true\2/' \
   docs/{gst,libs}/Makefile.in &&
 ./configure --prefix=/usr \
-            --libexecdir=/usr/lib &&
+            --libexecdir=/usr/lib \
+            --disable-static &&
 make</userinput></screen>
 
-    <para>To test the results, issue: <command>make check</command>. There are
-    many other <filename>Makefile</filename> targets you can specify for
-    running the tests, issue <command>make -C tests/check help</command> to see
-    the complete list.</para>
+    <para>
+      To test the results, issue: <command>make check</command>. There are
+      many other <filename>Makefile</filename> targets you can specify for
+      running the tests, issue <command>make -C tests/check help</command>
+      to see the complete list.
+    </para>
 
-    <para>Now, as the <systemitem class="username">root</systemitem> user:</para>
+    <para>
+      Now, as the <systemitem class="username">root</systemitem> user:
+    </para>
 
 <screen role="root"><userinput>make install &&
 install -v -m755 -d /usr/share/doc/gstreamer-0.10/design &&
@@ -152,17 +159,21 @@
     <sect3>
       <title>Testing the Installation</title>
 
-      <para>To test the functionality of the
-      <application>GStreamer</application> installation, you can run a simple
-      test as an unprivileged user (you may have to run
-      <command>ldconfig</command> as the
-      <systemitem class="username">root</systemitem> user before attempting
-      the test).</para>
+      <para>
+        To test the functionality of the
+        <application>GStreamer</application> installation, you can run a
+        simple test as an unprivileged user (you may have to run
+        <command>ldconfig</command> as the
+        <systemitem class="username">root</systemitem> user before
+        attempting the test).
+      </para>
 
 <screen><userinput>gst-launch -v fakesrc num_buffers=5 ! fakesink</userinput></screen>
 
-      <para>If the command outputs a series of messages from fakesrc and
-      fakesink, everything is okay.</para>
+      <para>
+        If the command outputs a series of messages from fakesrc and
+        fakesink, everything is okay.
+      </para>
 
     </sect3>
 
@@ -171,36 +182,44 @@
   <sect2 role="commands">
     <title>Command Explanations</title>
 
-    <para><option>sed -i 's/\(.*gtkdoc-rebase --relative.* \)\(;.*\)/\1|| true\2/' \
-    docs/{gst,libs}/Makefile.in</option>: Two of the Makefiles test if
-    <command>gtkdoc-rebase</command> is present, and only use it if it is,
-    but the test <command>which gtk-doc</command> is interpreted as an error by
-    <command>make</command> if <command>gtkdoc-rebase</command> is not present.  The
-    <command>sed</command> command ensures the command is always regarded as
-    successful.</para>
+    <para>
+      <command>sed -i 's/\(.*gtkdoc-rebase --relative.* \)\(;.*\)/\1|| true\2/' \
+      docs/{gst,libs}/Makefile.in</command>: Two of the Makefiles test if
+      <command>gtkdoc-rebase</command> is present, and only use it if it is,
+      but the test <command>which gtk-doc</command> is interpreted as an error by
+      <command>make</command> if <command>gtkdoc-rebase</command> is not present.
+      The <command>sed</command> command ensures the command is always regarded as
+      successful.
+    </para>
 
-    <para><parameter>--libexecdir=/usr/lib</parameter>: This parameter is used
-    so that the <application>GStreamer</application> internal support programs
-    are installed in the preferred location of <filename
-    class='directory'>/usr/lib/gstreamer-0.10</filename> instead of <filename
-    class='directory'>/usr/libexec/gstreamer-0.10</filename>.</para>
+    <para>
+      <parameter>--libexecdir=/usr/lib</parameter>: This parameter is used
+      so that the <application>GStreamer</application> internal support programs
+      are installed in the preferred location of <filename
+      class="directory">/usr/lib/gstreamer-0.10</filename> instead of <filename
+      class="directory">/usr/libexec/gstreamer-0.10</filename>.
+    </para>
 
     <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
-    href="../../xincludes/gtk-doc-rebuild.xml"/>
+      href="../../xincludes/static-libraries.xml"/>
 
-    <para><option>--disable-static</option>: This switch prevents the static
-    libraries from being built.</para>
+    <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
+      href="../../xincludes/gtk-doc-rebuild.xml"/>
 
-    <para><option>--enable-docbook</option>: This parameter is used to build
-    HTML, PDF and PostScript versions of the
-    <application>GStreamer</application> User's Manual, FAQ and Writer's Guide.
-    Note that you must have all the listed dependencies installed.</para>
+    <para>
+      <option>--enable-docbook</option>: This parameter is used to build
+      HTML, PDF and PostScript versions of the
+      <application>GStreamer</application> User's Manual, FAQ and Writer's
+      Guide. Note that you must have all the listed dependencies installed.
+    </para>
 
-    <para><command>chown -v -R root:root ...</command>: The documentation is
-    installed with ownerships of the user who untarred and built the package.
-    This command changes the ownerships of the installed documentation files to
-    root:root and is only executed if the documentation files were built and
-    installed.</para>
+    <para>
+      <command>chown -v -R root:root ...</command>: The documentation is
+      installed with ownerships of the user who untarred and built the
+      package. This command changes the ownerships of the installed
+      documentation files to root:root and is only executed if the
+      documentation files were built and installed.
+    </para>
 
   </sect2>
 
@@ -213,18 +232,24 @@
       <segtitle>Installed Directories</segtitle>
 
       <seglistitem>
-        <seg>gst-feedback, gst-feedback-0.10, gst-inspect, gst-inspect-0.10,
-        gst-launch, gst-launch-0.10, gst-plugin-scanner, gst-typefind,
-        gst-typefind-0.10, gst-xmlinspect, gst-xmlinspect-0.10, gst-xmllaunch,
-        and gst-xmllaunch-0.10</seg>
-        <seg>libgstbase-0.10.{so,a}, libgstcheck-0.10.{so,a},
-        libgstcontroller-0.10.{so,a}, libgstcoreelements.so,
-        libgstcoreindexers.so, libgstdataprotocol-0.10.{so,a},
-        libgstnet-0.10.{so,a}, and libgstreamer-0.10.{so,a}</seg>
-        <seg>/usr/{include/gstreamer-0.10/gst/{base,check,controller,
-        dataprotocol,net},lib/{gstreamer-0.10,gstreamer/gstreamer-0.10},
-        share/{gstreamer-0.10/presets,gtk-doc/html/{gstreamer-0.10,
-        gstreamer-libs-0.10,gstreamer-plugins-0.10}}}</seg>
+        <seg>
+          gst-feedback, gst-feedback-0.10, gst-inspect, gst-inspect-0.10,
+          gst-launch, gst-launch-0.10, gst-typefind, gst-typefind-0.10,
+          gst-xmlinspect, gst-xmlinspect-0.10, gst-xmllaunch and
+          gst-xmllaunch-0.10 
+        </seg>
+        <seg>
+          libgstbase-0.10.so, libgstcheck-0.10.so, libgstcontroller-0.10.so,
+          libgstdataprotocol-0.10.so, libgstnet-0.10.so and
+          libgstreamer-0.10.so
+        </seg>
+        <seg>
+          /usr/include/gstreamer-0.10,
+          /usr/lib/gstreamer-0.10,
+          /usr/share/gtk-doc/html/gstreamer-0.10,
+          /usr/share/gtk-doc/html/gstreamer-libs-0.10 and
+          /usr/share/gtk-doc/html/gstreamer-plugins-0.10
+        </seg>
       </seglistitem>
     </segmentedlist>
 
@@ -236,8 +261,10 @@
       <varlistentry id="gst-feedback">
         <term><command>gst-feedback-0.10</command></term>
         <listitem>
-          <para>generates debug info for <application>GStreamer</application>
-          bug reports.</para>
+          <para>
+            generates debug info for <application>GStreamer</application>
+            bug reports.
+          </para>
           <indexterm zone="gstreamer gst-feedback">
             <primary sortas="b-gst-feedback">gst-feedback-0.10</primary>
           </indexterm>
@@ -247,8 +274,10 @@
       <varlistentry id="gst-inspect">
         <term><command>gst-inspect-0.10</command></term>
         <listitem>
-          <para>prints information about a
-          <application>GStreamer</application> plugin or element.</para>
+          <para>
+            prints information about a
+            <application>GStreamer</application> plugin or element.
+          </para>
           <indexterm zone="gstreamer gst-inspect">
             <primary sortas="b-gst-inspect">gst-inspect-0.10</primary>
           </indexterm>
@@ -258,8 +287,10 @@
       <varlistentry id="gst-launch">
         <term><command>gst-launch-0.10</command></term>
         <listitem>
-          <para>is a tool that builds and runs basic
-          <application>GStreamer</application> pipelines.</para>
+          <para>
+            is a tool that builds and runs basic
+            <application>GStreamer</application> pipelines.
+          </para>
           <indexterm zone="gstreamer gst-launch">
             <primary sortas="b-gst-launch">gst-launch-0.10</primary>
           </indexterm>
@@ -269,10 +300,12 @@
       <varlistentry id="gst-typefind">
         <term><command>gst-typefind-0.10</command></term>
         <listitem>
-          <para>uses the <application>GStreamer</application> type finding
-          system to determine the relevant <application>GStreamer</application>
-          plugin to parse or decode a file, and determine the corresponding
-          MIME type.</para>
+          <para>
+            uses the <application>GStreamer</application> type finding system
+            to determine the relevant <application>GStreamer</application>
+            plugin to parse or decode a file, and determine the corresponding
+            MIME type.
+          </para>
           <indexterm zone="gstreamer gst-typefind">
             <primary sortas="b-gst-typefind">gst-typefind-0.10</primary>
           </indexterm>
@@ -282,8 +315,10 @@
       <varlistentry id="gst-xmlinspect">
         <term><command>gst-xmlinspect-0.10</command></term>
         <listitem>
-          <para>prints information about a <application>GStreamer</application>
-          plugin or element in XML document format.</para>
+          <para>
+            prints information about a <application>GStreamer</application>
+            plugin or element in XML document format.
+          </para>
           <indexterm zone="gstreamer gst-xmlinspect">
             <primary sortas="b-gst-xmlinspect">gst-xmlinspect-0.10</primary>
           </indexterm>
@@ -293,8 +328,10 @@
       <varlistentry id="gst-xmllaunch">
         <term><command>gst-xmllaunch-0.10</command></term>
         <listitem>
-          <para>is used to build and run a basic <application>GStreamer</application>
-          pipeline, loading it from an XML description.</para>
+          <para>
+            is used to build and run a basic <application>GStreamer</application>
+            pipeline, loading it from an XML description.
+          </para>
           <indexterm zone="gstreamer gst-xmllaunch">
             <primary sortas="b-gst-xmllaunch">gst-xmllaunch-0.10</primary>
           </indexterm>

Modified: trunk/BOOK/multimedia/libdriv/libcanberra.xml
===================================================================
--- trunk/BOOK/multimedia/libdriv/libcanberra.xml	2012-07-24 02:10:09 UTC (rev 10462)
+++ trunk/BOOK/multimedia/libdriv/libcanberra.xml	2012-07-24 16:16:08 UTC (rev 10463)
@@ -30,31 +30,45 @@
   <sect2 role="package">
     <title>Introduction to libcanberra</title>
 
-    <para>The <application>libcanberra</application> is an implementation of the
-    XDG Sound Theme and Name Specifications, for generating event sounds on free
-    desktops, such as <application>GNOME</application>.</para>
+    <para>
+      <application>libcanberra</application> is an implementation of the XDG Sound
+      Theme and Name Specifications, for generating event sounds on free desktops,
+      such as <application>GNOME</application>.
+    </para>
 
     &lfs70_checked;
 
     <bridgehead renderas="sect3">Package Information</bridgehead>
     <itemizedlist spacing="compact">
       <listitem>
-        <para>Download (HTTP): <ulink url="&libcanberra-download-http;"/></para>
+        <para>
+          Download (HTTP): <ulink url="&libcanberra-download-http;"/>
+        </para>
       </listitem>
       <listitem>
-        <para>Download (FTP): <ulink url="&libcanberra-download-ftp;"/></para>
+        <para>
+          Download (FTP): <ulink url="&libcanberra-download-ftp;"/>
+        </para>
       </listitem>
       <listitem>
-        <para>Download MD5 sum: &libcanberra-md5sum;</para>
+        <para>
+          Download MD5 sum: &libcanberra-md5sum;
+        </para>
       </listitem>
       <listitem>
-        <para>Download size: &libcanberra-size;</para>
+        <para>
+          Download size: &libcanberra-size;
+        </para>
       </listitem>
       <listitem>
-        <para>Estimated disk space required: &libcanberra-buildsize;</para>
+        <para>
+          Estimated disk space required: &libcanberra-buildsize;
+        </para>
       </listitem>
       <listitem>
-        <para>Estimated build time: &libcanberra-time;</para>
+        <para>
+          Estimated build time: &libcanberra-time;
+        </para>
       </listitem>
     </itemizedlist>
 
@@ -86,23 +100,30 @@
     </para>
 
     <para condition="html" role="usernotes">User Notes:
-    <ulink url="&blfs-wiki;/libcanberra"/></para>
-
+      <ulink url="&blfs-wiki;/libcanberra"/>
+    </para>
   </sect2>
 
   <sect2 role="installation">
     <title>Installation of libcanberra</title>
 
-    <para>Install <application>libcanberra</application> by running the following
-    commands:</para>
+    <para>
+      Install <application>libcanberra</application> by running the following
+      commands:
+    </para>
 
-<screen><userinput>./configure --prefix=/usr --sysconfdir=/etc \
+<screen><userinput>./configure --prefix=/usr \
+            --sysconfdir=/etc \
             --disable-oss &&
 make</userinput></screen>
 
-    <para>This package does not come with a test suite.</para>
+    <para>
+      This package does not come with a test suite.
+    </para>
 
-    <para>Now, as the <systemitem class="username">root</systemitem> user:</para>
+    <para>
+      Now, as the <systemitem class="username">root</systemitem> user:
+    </para>
 
 <screen role="root"><userinput>make install</userinput></screen>
 
@@ -112,7 +133,7 @@
     <title>Command Explanations</title>
 
     <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
-    href="../../xincludes/gtk-doc-rebuild.xml"/>
+      href="../../xincludes/gtk-doc-rebuild.xml"/>
 
   </sect2>
 
@@ -133,8 +154,9 @@
           libcanberra.so
         </seg>
         <seg>
-          /usr/lib/libcanberra-0.28, /usr/share/doc/libcanberra 
-          and /usr/share/gtk-doc/html/libcanberra
+          /usr/lib/libcanberra-0.28,
+          /usr/share/doc/libcanberra and
+          /usr/share/gtk-doc/html/libcanberra
         </seg>
       </seglistitem>
     </segmentedlist>
@@ -147,7 +169,9 @@
       <varlistentry id="canberra-gtk-play">
         <term><command>canberra-gtk-play</command></term>
         <listitem>
-          <para>is an application for playing sound events.</para>
+          <para>
+            is an application used for playing sound events.
+          </para>
           <indexterm zone="libcanberra canberra-gtk-play">
             <primary sortas="b-canberra-gtk-play">canberra-gtk-play</primary>
           </indexterm>
@@ -157,7 +181,10 @@
       <varlistentry id="libcanberra-gtk">
         <term><filename class='libraryfile'>libcanberra-gtk.so</filename></term>
         <listitem>
-          <para>contains the libcanberra bindings for GTK+2.</para>
+          <para>
+            contains the <application>libcanberra</application> bindings
+            for <application>GTK+ 2</application>.
+          </para>
           <indexterm zone="libcanberra libcanberra-gtk">
             <primary sortas="c-libcanberra-gtk">libcanberra-gtk.so</primary>
           </indexterm>
@@ -167,7 +194,10 @@
       <varlistentry id="libcanberra-gtk3">
         <term><filename class='libraryfile'>libcanberra-gtk3.so</filename></term>
         <listitem>
-          <para>contains the libcanberra bindings for GTK+3.</para>
+          <para>
+            contains the <application>libcanberra</application> bindings
+            for <application>GTK+ 3</application>.
+          </para>
           <indexterm zone="libcanberra libcanberra-gtk3">
             <primary sortas="c-libcanberra-gtk3">libcanberra-gtk3.so</primary>
           </indexterm>
@@ -177,7 +207,9 @@
       <varlistentry id="libcanberra-lib">
         <term><filename class='libraryfile'>libcanberra.so</filename></term>
         <listitem>
-          <para>contains the libcanberra API functions.</para>
+          <para>
+            contains the <application>libcanberra</application> API functions.
+          </para>
           <indexterm zone="libcanberra libcanberra-lib">
             <primary sortas="c-libcanberra">libcanberra.so</primary>
           </indexterm>




More information about the blfs-book mailing list