Author: andy
Date: 2012-04-21 07:04:37 -0600 (Sat, 21 Apr 2012)
New Revision: 9965

Modified:
   trunk/BOOK/multimedia/videoutils/vlc.xml
Log:
make alsa lib a recommended dep of vlc

Modified: trunk/BOOK/multimedia/videoutils/vlc.xml
===================================================================
--- trunk/BOOK/multimedia/videoutils/vlc.xml    2012-04-21 12:39:08 UTC (rev 
9964)
+++ trunk/BOOK/multimedia/videoutils/vlc.xml    2012-04-21 13:04:37 UTC (rev 
9965)
@@ -31,34 +31,48 @@
   <sect2 role="package">
     <title>Introduction to VLC</title>
 
-    <para><application>VLC</application> is a media player, streamer, and
-    encoder. It can play from many inputs like files, network streams, capture
-    device, desktops, or DVD, SVCD, VCD, and audio
-    CD. It can play most audio and video codecs (MPEG 1/2/4, H264, VC-1, DivX,
-    WMV, Vorbis, AC3, AAC, etc.), but can also convert to different formats
-    and/or send streams through the network.</para>
+    <para>
+      <application>VLC</application> is a media player, streamer, and encoder.
+      It can play from many inputs like files, network streams, capture device,
+      desktops, or DVD, SVCD, VCD, and audio CD. It can play most audio and
+      video codecs (MPEG 1/2/4, H264, VC-1, DivX, WMV, Vorbis, AC3, AAC, etc.),
+      but can also convert to different formats and/or send streams through the
+      network.
+    </para>
 
     &lfs70_checked;
 
     <bridgehead renderas="sect3">Package Information</bridgehead>
     <itemizedlist spacing="compact">
       <listitem>
-        <para>Download (HTTP): <ulink url="&vlc-download-http;"/></para>
+        <para>
+          Download (HTTP): <ulink url="&vlc-download-http;"/>
+        </para>
       </listitem>
       <listitem>
-        <para>Download (FTP): <ulink url="&vlc-download-ftp;"/></para>
+        <para>
+          Download (FTP): <ulink url="&vlc-download-ftp;"/>
+        </para>
       </listitem>
       <listitem>
-        <para>Download MD5 sum: &vlc-md5sum;</para>
+        <para>
+          Download MD5 sum: &vlc-md5sum;
+        </para>
       </listitem>
       <listitem>
-        <para>Download size: &vlc-size;</para>
+        <para>
+          Download size: &vlc-size;
+        </para>
       </listitem>
       <listitem>
-        <para>Estimated disk space required: &vlc-buildsize;</para>
+        <para>
+          Estimated disk space required: &vlc-buildsize;
+        </para>
       </listitem>
       <listitem>
-        <para>Estimated build time: &vlc-time;</para>
+        <para>
+          Estimated build time: &vlc-time;
+        </para>
       </listitem>
     </itemizedlist>
 
@@ -66,131 +80,139 @@
 
     <bridgehead renderas="sect4">Required</bridgehead>
     <para role="required">
-    <xref linkend="dbus"/>
+      <xref linkend="dbus"/>
     </para>
 
     <bridgehead renderas="sect4">Recommended</bridgehead>
     <para role="recommended">
-    <xref linkend="ffmpeg"/>,
-    <xref linkend="libmad"/>,
-    <xref linkend="liba52"/> and
-    <xref linkend="qt4"/> (<application>Qt</application>
-    is required for the graphical user interface. Without Qt you will only be 
able 
-    to use the command line or <application>ncurses</application> 
interface)</para>
+      <xref linkend="alsa-lib"/>,
+      <xref linkend="ffmpeg"/>,
+      <xref linkend="libmad"/>,
+      <xref linkend="liba52"/> and
+      <xref linkend="qt4"/> (<application>Qt4</application> is required for the
+      graphical user interface. Without Qt4 you will only be able to use the
+      command line or <application>ncurses</application> interface)
+    </para>
 
-    <bridgehead renderas="sect4">Optional input drivers and
-    libraries</bridgehead>
+    <bridgehead renderas="sect4">Optional input drivers and 
libraries</bridgehead>
     <para role="optional">
-    <xref linkend="libproxy"/>,
-    <ulink url="http://www.live555.com/";>Live555</ulink>,
-    <ulink url="http://sourceforge.net/projects/libdc1394/";>DC1394</ulink>,
-    <xref linkend="libdv"/>,
-    <xref linkend="libdvdread"/>,
-    <xref linkend="libdvdnav"/>,
-    <ulink
-    url="http://www.videolan.org/developers/libbluray.html";>libbluray</ulink>,
-    <ulink url="http://opencv.willowgarage.com/wiki/";>OpenCV</ulink>,
-    <xref linkend="samba3"/>,
-    <xref linkend="gvfs"/>,
-    <ulink url="http://wiki.videolan.org/Libvcdinfo";>libvcdinfo</ulink> and
-    <ulink url="http://libcddb.sourceforge.net/";>libcddb</ulink>.</para>
+      <xref linkend="libproxy"/>,
+      <ulink url="http://www.live555.com/";>Live555</ulink>,
+      <ulink url="http://sourceforge.net/projects/libdc1394/";>DC1394</ulink>,
+      <xref linkend="libdv"/>,
+      <xref linkend="libdvdread"/>,
+      <xref linkend="libdvdnav"/>,
+      <ulink 
url="http://www.videolan.org/developers/libbluray.html";>libbluray</ulink>,
+      <ulink url="http://opencv.willowgarage.com/wiki/";>OpenCV</ulink>,
+      <xref linkend="samba3"/>,
+      <xref linkend="gvfs"/>,
+      <ulink url="http://wiki.videolan.org/Libvcdinfo";>libvcdinfo</ulink> and
+      <ulink url="http://libcddb.sourceforge.net/";>libcddb</ulink>.
+    </para>
 
     <bridgehead renderas="sect4">Optional mux/demux plugins</bridgehead>
     <para role="optional">
-    <ulink url="http://code.google.com/p/game-music-emu/";>Game Music
-    Emu</ulink>,
-    <xref linkend="libogg"/>,
-    <ulink url="http://directory.fsf.org/wiki/Libshout";>libshout</ulink>,
-    <ulink url="http://modplug-xmms.sourceforge.net/";>libmod</ulink> and
-    <ulink
-    url="http://www.musepack.net/index.php?pg=home";>Musepack</ulink>.</para>
+      <ulink url="http://code.google.com/p/game-music-emu/";>Game Music 
Emu</ulink>,
+      <xref linkend="libogg"/>,
+      <ulink url="http://directory.fsf.org/wiki/Libshout";>libshout</ulink>,
+      <ulink url="http://modplug-xmms.sourceforge.net/";>libmod</ulink> and
+      <ulink url="http://www.musepack.net/index.php?pg=home";>Musepack</ulink>.
+    </para>
 
     <bridgehead renderas="sect4">Optional codec plugins</bridgehead>
     <para role="optional">
-    <ulink url="http://sourceforge.net/projects/libshine-fxp/";>Shine</ulink>,
-    <ulink url="http://www.khronos.org/openmax/";>OpenMAX</ulink>,
-    <ulink url="http://www.splitted-desktop.com/static/libva/";>libva</ulink>,
-    <xref linkend="faad2"/>,
-    <ulink url="http://www.twolame.org/";>Twolame</ulink>,
-    <ulink url="http://www.videolan.org/developers/libdca.html";>libdca</ulink>,
-    <xref linkend="flac"/>,
-    <xref linkend="libmpeg2"/>,
-    <xref linkend="libvorbis"/>,
-    <xref linkend="speex"/>,
-    <xref linkend="libtheora"/>,
-    <ulink url="http://diracvideo.org/download/dirac-research/";>Dirac</ulink>,
-    <ulink
-    url="http://diracvideo.org/download/schroedinger/";>Schroedinger</ulink>,
-    <xref linkend="libpng"/>,
-    <ulink url="http://www.videolan.org/developers/x264.html";>libx264</ulink>,
-    <ulink
-    url="http://sourceforge.net/apps/trac/fluidsynth/";>FluidSynth</ulink>,
-    <ulink url="http://zapping.sourceforge.net/ZVBI/index.html";>Zapping
-    VBI</ulink>,
-    <ulink url="http://code.google.com/p/libass/";>libass</ulink>,
-    <ulink url="http://code.google.com/p/libkate/";>libkate</ulink> and
-    <ulink url="http://code.google.com/p/libtiger/";>libtiger</ulink>.</para>
+      <ulink url="http://sourceforge.net/projects/libshine-fxp/";>Shine</ulink>,
+      <ulink url="http://www.khronos.org/openmax/";>OpenMAX</ulink>,
+      <ulink url="http://www.splitted-desktop.com/static/libva/";>libva</ulink>,
+      <xref linkend="faad2"/>,
+      <ulink url="http://www.twolame.org/";>Twolame</ulink>,
+      <ulink 
url="http://www.videolan.org/developers/libdca.html";>libdca</ulink>,
+      <xref linkend="flac"/>,
+      <xref linkend="libmpeg2"/>,
+      <xref linkend="libvorbis"/>,
+      <xref linkend="speex"/>,
+      <xref linkend="libtheora"/>,
+      <ulink 
url="http://diracvideo.org/download/dirac-research/";>Dirac</ulink>,
+      <ulink 
url="http://diracvideo.org/download/schroedinger/";>Schroedinger</ulink>,
+      <xref linkend="libpng"/>,
+      <ulink 
url="http://www.videolan.org/developers/x264.html";>libx264</ulink>,
+      <ulink 
url="http://sourceforge.net/apps/trac/fluidsynth/";>FluidSynth</ulink>,
+      <ulink url="http://zapping.sourceforge.net/ZVBI/index.html";>Zapping 
VBI</ulink>,
+      <ulink url="http://code.google.com/p/libass/";>libass</ulink>,
+      <ulink url="http://code.google.com/p/libkate/";>libkate</ulink> and
+      <ulink url="http://code.google.com/p/libtiger/";>libtiger</ulink>.
+    </para>
 
     <bridgehead renderas="sect4">Optional video plugins</bridgehead>
     <para role="optional">
-    <xref linkend="sdl"/>,
-    <xref linkend="freetype2"/>,
-    <xref linkend="fribidi"/>,
-    <xref linkend="fontconfig"/>,
-    <xref linkend="aalib"/> and
-    <ulink url="http://caca.zoy.org/";>libcaca</ulink>.</para>
+      <xref linkend="sdl"/>,
+      <xref linkend="freetype2"/>,
+      <xref linkend="fribidi"/>,
+      <xref linkend="fontconfig"/>,
+      <xref linkend="aalib"/> and
+      <ulink url="http://caca.zoy.org/";>libcaca</ulink>.
+    </para>
 
     <bridgehead renderas="sect4">Optional audio plugins</bridgehead>
     <para role="optional">
-    <xref linkend="pulseaudio"/>,
-    <xref linkend="alsa-lib"/>,
-    <ulink url="http://www.portaudio.com/";>PortAudio</ulink>,
-    <ulink url="http://jackaudio.org/";>JACK</ulink> and
-    <ulink url="http://www.mega-nerd.com/SRC/";>libsamplerate</ulink>.</para>
+      <xref linkend="pulseaudio"/>,
+      <ulink url="http://www.portaudio.com/";>PortAudio</ulink>,
+      <ulink url="http://jackaudio.org/";>JACK</ulink> and
+      <ulink url="http://www.mega-nerd.com/SRC/";>libsamplerate</ulink>.
+    </para>
 
     <bridgehead renderas="sect4">Optional interface plugins</bridgehead>
-    <para role="optional"><ulink url="http://www.lirc.org/";>LIRC</ulink> and
-    <ulink url="http://www.feep.net/libtar/";>libtar</ulink>.</para>
+    <para role="optional">
+      <ulink url="http://www.lirc.org/";>LIRC</ulink> and
+      <ulink url="http://www.feep.net/libtar/";>libtar</ulink>.
+    </para>
 
     <bridgehead renderas="sect4">Optional visualization plugins</bridgehead>
     <para role="optional">
-    <ulink url="http://sourceforge.net/projects/goom/";>Goom</ulink> and
-    <ulink url="http://projectm.sourceforge.net/";>projectM</ulink>.</para>
+      <ulink url="http://sourceforge.net/projects/goom/";>Goom</ulink> and
+      <ulink url="http://projectm.sourceforge.net/";>projectM</ulink>.
+    </para>
 
     <bridgehead renderas="sect4">Optional service discovery 
plugins</bridgehead>
     <para role="optional">
-    <ulink url="http://libmtp.sourceforge.net/";>MTP</ulink> and
-    <ulink url="http://pupnp.sourceforge.net/";>UPnP</ulink>.</para>
+      <ulink url="http://libmtp.sourceforge.net/";>MTP</ulink> and
+      <ulink url="http://pupnp.sourceforge.net/";>UPnP</ulink>.
+    </para>
 
-    <bridgehead renderas="sect4">Optional miscellaneous
-    dependencies</bridgehead>
+    <bridgehead renderas="sect4">Optional miscellaneous 
dependencies</bridgehead>
     <para role="optional">
-    <xref linkend="libgcrypt"/>,
-    <xref linkend="gnutls"/>,
-    <xref linkend="libnotify"/>,
-    <xref linkend="taglib"/>, 
-    <ulink url="http://medialibrary.sourceforge.net/";>MediaLibrary</ulink>,
-    <xref linkend="sqlite"/> and
-    <ulink url="http://www.lua.org/";>Lua</ulink>.</para>
+      <xref linkend="libgcrypt"/>,
+      <xref linkend="gnutls"/>,
+      <xref linkend="libnotify"/>,
+      <xref linkend="taglib"/>, 
+      <ulink url="http://medialibrary.sourceforge.net/";>MediaLibrary</ulink>,
+      <xref linkend="sqlite"/> and
+      <ulink url="http://www.lua.org/";>Lua</ulink>.
+    </para>
 
-    <para condition="html" role="usernotes">User Notes:
-    <ulink url="&blfs-wiki;/vlc"/></para>
+    <para condition="html" role="usernotes">
+      User Notes: <ulink url="&blfs-wiki;/vlc"/>
+    </para>
   </sect2>
 
   <sect2 role="installation">
     <title>Installation of VLC</title>
 
-    <para>Install <application>VLC</application> by running the following
-    commands:</para>
+    <para>
+      Install <application>VLC</application> by running the following commands:
+    </para>
 
 <screen><userinput>./configure --prefix=/usr \
     --disable-lua &amp;&amp;
 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>
@@ -198,15 +220,26 @@
   <sect2 role="commands">
     <title>Command Explanations</title>
 
-    <para><parameter>--disable-lua</parameter>: The package fails to install if
-    Lua is missing. Omit this option if you have Lua.</para>
-    <para><parameter>--disable-avcodec</parameter>: Use this switch if you 
don't 
-    have ffmpeg.</para>
-    <para><parameter>--disable-mad</parameter>: Use this switch if you don't 
-    have libmad.</para>
-    <para><parameter>--disable-a52</parameter>: Use this switch if you don't 
-    have liba52.</para>
-    
+    <para>
+      <parameter>--disable-lua</parameter>: The package fails to install if
+      <application>Lua</application> is missing. Omit this option if you have
+      installed <application>Lua</application>.
+    </para>
+
+    <para>
+      <parameter>--disable-avcodec</parameter>: Use this switch if you don't 
+      have <application>FFmpeg</application> installed.
+    </para>
+
+    <para>
+      <parameter>--disable-mad</parameter>: Use this switch if you don't 
+      have <application>libmad</application> installed.
+    </para>
+
+    <para>
+      <parameter>--disable-a52</parameter>: Use this switch if you don't have
+      <application>liba52</application> installed.
+    </para>
   </sect2>
 
   <sect2 role="content">
@@ -220,9 +253,9 @@
       <seglistitem>
         <seg>cvlc, qvlc, rvlc, svlc, vlc and vlc-wrapper</seg>
         <seg>libvlccore.so, libvlc.so and several libraries in
-        /usr/lib/vlc/plugins</seg>
+        /usr/lib/vlc/plugins.</seg>
         <seg>/usr/lib/vlc, /usr/include/vlc, /usr/share/vlc and
-        /usr/share/doc/vlc</seg>
+        /usr/share/doc/vlc.</seg>
       </seglistitem>
     </segmentedlist>
 
@@ -234,7 +267,9 @@
       <varlistentry id="cvlc">
         <term><command>cvlc</command></term>
         <listitem>
-          <para>script to run VLC with the dummy interface</para>
+          <para>
+            is a script to run VLC with the dummy interface.
+          </para>
           <indexterm zone="vlc cvlc">
             <primary sortas="b-cvlc">cvlc</primary>
           </indexterm>
@@ -244,7 +279,10 @@
       <varlistentry id="qvlc">
         <term><command>qvlc</command></term>
         <listitem>
-          <para>script to run VLC with the QT4 interface</para>
+          <para>
+            is a script to run <application>VLC</application> with the
+            <application>QT4</application> interface.
+          </para>
           <indexterm zone="vlc qvlc">
             <primary sortas="b-qvlc">qvlc</primary>
           </indexterm>
@@ -254,7 +292,10 @@
       <varlistentry id="rvlc">
         <term><command>rvlc</command></term>
         <listitem>
-          <para>script to run VLC with a command line interface</para>
+          <para>
+            is a script to run <application>VLC</application> with a command
+            line interface.
+          </para>
           <indexterm zone="vlc rvlc">
             <primary sortas="b-rvlc">rvlc</primary>
           </indexterm>
@@ -264,7 +305,10 @@
       <varlistentry id="svlc">
         <term><command>svlc</command></term>
         <listitem>
-          <para>script to run VLC with the skins interface</para>
+          <para>
+            is a script to run <application>VLC</application> with the skins
+            interface.
+          </para>
           <indexterm zone="vlc svlc">
             <primary sortas="b-svlc">svlc</primary>
           </indexterm>
@@ -274,7 +318,9 @@
       <varlistentry id="vlc-prog">
         <term><command>vlc</command></term>
         <listitem>
-          <para>the VLC media player</para>
+          <para>
+            is the <application>VLC</application> media player.
+          </para>
           <indexterm zone="vlc vlc-prog">
             <primary sortas="b-vlc">vlc</primary>
           </indexterm>
@@ -284,7 +330,9 @@
        <varlistentry id="vlc-wrapper">
         <term><command>vlc-wrapper</command></term>
         <listitem>
-          <para>a wrapper to drop privileges with VLC</para>
+          <para>
+            is a wrapper to drop privileges with <application>VLC</application>
+          </para>
           <indexterm zone="vlc vlc-wrapper">
             <primary sortas="b-vlc-wrapper">vlc-wrapper</primary>
           </indexterm>

-- 
http://linuxfromscratch.org/mailman/listinfo/blfs-book
FAQ: http://www.linuxfromscratch.org/blfs/faq.html
Unsubscribe: See the above information page

Reply via email to