update into to mpg123, vorbistools and xmms

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@1131 af4574ff-66df-0310-9fd7-8a98e5e911e0

multimedia/audioutils/mpg123.xml

@@ -4,7 +4,6 @@
 
 &mpg123-intro;
 &mpg123-inst;
-&mpg123-exp;
 &mpg123-desc;
 
 </sect1>

multimedia/audioutils/mpg123/mpg123-desc.xml

@@ -1,14 +1,16 @@
 <sect2>
 <title>Contents</title>
 
-<para>The mpg123 package contains <userinput>mpg123</userinput>.</para>
+<para>The <application>mpg123</application> package contains <command>mpg123
+</command>.</para>
 
 </sect2>
 
 <sect2><title>Description</title>
 
 <sect3><title>mpg123</title>
-<para>mpg123 is used for playing mp3 files via the console.</para></sect3>
+<para><command>mpg123</command> is used for playing mp3 files via the console.
+</para></sect3>
 
 </sect2>
 

multimedia/audioutils/mpg123/mpg123-exp.xml

@@ -1,12 +1,11 @@
 <sect2>
 <title>Command explanations</title>
 
-<para><userinput>make linux</userinput> : This command builds 
+<para><command>make linux</command> : This command builds 
-mpg123 for linux.</para>
+<application>mpg123</application> for Linux.</para>
-<para><userinput>make linux-help</userinput> : This command lists 
+
-all build-options for mpg123.</para>
+<para><command>make linux-help</command> : This command lists 
-<para><userinput>make install</userinput> : This command installs 
+all build-options for <application>mpg123</application>.</para>
-mpg123 in <filename>/usr/local/bin</filename>.</para>
 
 </sect2>
 

multimedia/audioutils/mpg123/mpg123-inst.xml

@@ -1,19 +1,12 @@
 <sect2>
-<title>Installation of mpg123</title>
+<title>Installation of <application>mpg123</application></title>
 
-<para>Install mpg123 by running the following commands:</para>
+<para>Install <application>mpg123</application> by running the following 
+commands:</para>
 
-<para><screen><userinput>make PREFIX=/usr linux &amp;&amp;</userinput>
+<screen><userinput><command>make PREFIX=/usr linux &amp;&amp;
-<userinput>make PREFIX=/usr install</userinput></screen></para>
+make PREFIX=/usr install</command></userinput></screen>
 
-<para>You can optimize the build of mpg123 for your processor. 
-To do this, type</para>
-<para><screen><userinput>make linux-help</userinput></screen></para>
-
-<para>and select the optimization appropriate for your machine.
-However, this may not always work.  There have been problems reported
-with using optimizations with mpg123; make PREFIX=/usr linux always
-seems to work.</para>
 
 </sect2>
 

multimedia/audioutils/mpg123/mpg123-intro.xml

@@ -1,16 +1,26 @@
 <sect2>
-<title>Introduction to mpg123</title>
+<title>Introduction to <application>mpg123</application></title>
 
-<screen>Download location (HTTP):       <ulink url="&mpg123-download-http;"/>
+<para>The <application>mpg123</application> package contains a console-based 
-Download location (FTP):        <ulink url="&mpg123-download-ftp;"/>
+mp3 player. It claims to be the fastest mp3 decoder for unix.</para>
-Version used:                   &mpg123-version;
-Package size:                   &mpg123-size;
-Estimated Disk space required:  &mpg123-buildsize;</screen>
 
-<para>The mpg123 package contains a console-based mp3-player. It claims to 
+<sect3><title>Package information</title>
-be the fastest mp3-decoder for unix.</para>
+<itemizedlist spacing='compact'>
+<listitem><para>Download (HTTP): <ulink
+url="&mpg123-download-http;"/></para></listitem>
+<listitem><para>Download (FTP): <ulink
+url="&mpg123-download-ftp;"/></para></listitem>
+<listitem><para>Download size: &mpg123-size;</para></listitem>
+<listitem><para>Estimated Disk space required:
+&mpg123-buildsize;</para></listitem>
+<listitem><para>Estimated build time:
+&mpg123-time;</para></listitem></itemizedlist>
+</sect3>
+                                                                                
+<sect3><title><application>mpg123</application> dependencies</title>
+<sect4><title>Required</title>
+<para>oss or <xref linkend="alsa-oss"/></para></sect4>
+</sect3>
 
-<screen>mpg123 depends on:
-oss or <xref linkend="alsa-oss"/></screen>
 
 </sect2>

multimedia/audioutils/vorbistools/vorbistools-desc.xml

@@ -1,37 +1,41 @@
 <sect2>
 <title>Contents</title>
 
-<para>The vorbis-tools package contains <userinput>oggdec</userinput>,
+<para>The <application>vorbis-tools</application> package contains
-<userinput>oggenc</userinput>,
+<command>oggdec</command>,
-<userinput>ogg123</userinput>, <userinput>vcut</userinput> and
+<command>oggenc</command>,
-<userinput>vorbiscomment</userinput>.</para>
+<command>ogg123</command>, <command>vcut</command> and
+<command>vorbiscomment</command>.</para>
 
 </sect2>
 
 <sect2><title>Description</title>
 
 <sect3><title>oggdec</title>
-<para>oggdec is a simple decoder which converts Ogg Vorbis file into 
+<para><command>oggdec</command> is a simple decoder which converts Ogg Vorbis 
-PCM audio files (WAV or RAW).</para></sect3>
+file into <acronym>PCM</acronym> audio files (<acronym>WAV</acronym> or
+raw.</para></sect3>
 
 <sect3><title>oggenc</title>
-<para>oggenc is the encoder that turns raw, WAV or AIFF files
+<para><command>oggenc</command> is the encoder that turns raw,
+<acronym>WAV</acronym> or <acronym>AIFF</acronym> files
 into an Ogg Vorbis stream.</para></sect3>
 
 <sect3><title>ogg123</title>
-<para>ogg123 is a command line audio player for Ogg Vorbis streams.</para></sect3>
+<para><command>ogg123</command> is a command line audio player for Ogg Vorbis 
+streams.</para></sect3>
 
 <sect3><title>ogginfo</title>
-<para>ogginfo prints information stored in the audio
+<para><command>ogginfo</command> prints information stored in the audio
 file.</para></sect3>
 
 <sect3><title>vcut</title>
-<para>vcut will split a file into two files at a designated cut
+<para><command>vcut</command> will split a file into two files at a designated 
-point.</para></sect3>
+cut point.</para></sect3>
 
 <sect3><title>vorbiscomment</title>
-<para>vorbiscomment is an editor that changes information in the audio
+<para><command>vorbiscomment</command> is an editor that changes information in 
-file metadata tags.</para></sect3>
+the audio file metadata tags.</para></sect3>
 
 </sect2>
 

multimedia/audioutils/vorbistools/vorbistools-inst.xml

@@ -1,11 +1,12 @@
 <sect2>
-<title>Installation of vorbis-tools</title>
+<title>Installation of <application>vorbis-tools</application></title>
 
-<para>Install vorbis-tools by running the following commands:</para>
+<para>Install <application>vorbis-tools</application> by running the following 
+commands:</para>
 
-<para><screen><userinput>./configure --prefix=/usr &amp;&amp;
+<screen><userinput><command>./configure --prefix=/usr &amp;&amp;
 make &amp;&amp;
-make install </userinput></screen></para>
+make install</command></userinput></screen>
 
 </sect2>
 

multimedia/audioutils/vorbistools/vorbistools-intro.xml

@@ -1,18 +1,28 @@
 <sect2>
-<title>Introduction to vorbis-tools</title>
+<title>Introduction to <application>vorbis-tools</application></title>
 
-<screen>Download location (HTTP):       <ulink url="&vorbistools-download-http;"/>
+<para>The <application>vorbis-tools</application> package contains command line 
-Download location (FTP):        <ulink url="&vorbistools-download-ftp;"/>
+tools for ogg audio files.  This is useful for encoding, playing or editing 
-Version used:                   &vorbistools-version;
+files using the ogg <acronym>CODEX</acronym>.</para>
-Package size:                   &vorbistools-size;
-Estimated Disk space required:  &vorbistools-buildsize;
-Estimated build time:           &vorbistools-time;</screen>
 
-<para>The vorbis-tools package contains command line tools for ogg audio
+<sect3><title>Package information</title>
-files.  This is useful for encoding, playing or editing files using the ogg CODEX.</para>
+<itemizedlist spacing='compact'>
+<listitem><para>Download (HTTP): <ulink
+url="&vorbistools-download-http;"/></para></listitem>
+<listitem><para>Download (FTP): <ulink
+url="&vorbistools-download-ftp;"/></para></listitem>
+<listitem><para>Download size: &vorbistools-size;</para></listitem>
+<listitem><para>Estimated Disk space required:
+&vorbistools-buildsize;</para></listitem>
+<listitem><para>Estimated build time:
+&vorbistools-time;</para></listitem></itemizedlist>
+</sect3>
+                                                                                
+<sect3><title><application>vorbis-tools</application> dependencies</title>
+<sect4><title>Required</title>
+<para><xref linkend="curl"/>, <xref linkend="libao"/>, <xref
+linkend="libogg"/> and <xref linkend="libvorbis"/></para></sect4>
+</sect3>
 
-<screen>vorbis-tools depends on:
-<xref linkend="curl"/>, <xref linkend="libao"/>, <xref
-linkend="libogg"/> and <xref linkend="libvorbis"/></screen>
 
 </sect2>

multimedia/audioutils/xmms/xmms-config.xml

@@ -1,5 +1,5 @@
 <sect2>
-<title>Configuring xmms</title>
+<title>Configuring <application>xmms</application></title>
 
 <sect3><title>Config files</title>
 <para><filename>~/.xmms/config</filename></para>
@@ -7,10 +7,10 @@
 
 <sect3><title>Configuration Information</title>
 
-<para>When you start XMMS for the first time, you can configure it with 
+<para>When you start <command>xmms</command> for the first time, you can 
-<userinput>CTRL+P</userinput> Note that you can extend XMMS' functionality
+configure it with <userinput>CTRL+P</userinput> Note that you can extend XMMS' 
-with plugins and skins. You can find these at <ulink url="http://xmms.org"/>. 
+functionality with plugins and skins. You can find these at 
-</para>
+<ulink url="http://xmms.org"/>.</para>
 </sect3>
 
 </sect2>

multimedia/audioutils/xmms/xmms-desc.xml

@@ -1,17 +1,18 @@
 <sect2>
 <title>Contents</title>
 
-<para>The xmms package contains <userinput>xmms</userinput>, <userinput>xmms-config</userinput>, <userinput>gnomexmss</userinput> and <userinput>wmxmms.</userinput></para>
+<para>The xmms package contains <command>xmms</command>, <command>xmms-config</command>, <command>gnomexmss</command> and <command>wmxmms.</command></para>
 
 </sect2>
 
 <sect2><title>Description</title>
 
 <sect3><title>xmms</title>
-<para>XMMS, which stands for X Multimedia System, is a program comparable in
+<para><acronym>XMMS</acronym>, which stands for X MultiMedia System, is a 
-function with WinAMP. It's main function is playing audio files like wav and
+program comparable in function with WinAMP. It's main function is playing audio 
-mp3. It can be extended with plugins to play a number of other audio or video
+files like wav and mp3. It can be extended with plugins to play a number of 
-formats. It's look can be customized with WinAMP style skins.</para></sect3>
+other audio or video formats. It's look can be customized with WinAMP style 
+skins.</para></sect3>
 
 <sect3><title>xmms-config</title>
 <para>This script is used by other programs which need to link with xmms to
@@ -19,9 +20,10 @@ retrieve the library and include paths XMMS was compiled with. </para></sect3>
 
 <sect3><title>gnomexmms</title>
 <para>This is an applet for the GNOME desktop environment that will dock into
-the GNOME panel. From the applet you can start and control xmms.</para></sect3>
+the GNOME panel. From the applet you can start and control
+<command>xmms</command>.</para></sect3>
 
 <sect3><title>wmxmms</title>
 <para>wmxmms is a dock applet for the Window Maker window manager. From the 
-applet you ca start and control xmms.</para></sect3>
+applet you ca start and control <command>xmms</command>.</para></sect3>
 </sect2>

multimedia/audioutils/xmms/xmms-exp.xml

@@ -1,9 +1,8 @@
 <sect2>
 <title>Command explanations</title>
 
-<para><screen><userinput>./configure --prefix=/usr \
+<para><command>./configure --prefix=/usr --enable-one-plugin-dir
---enable-one-plugin-dir &amp;&amp;</userinput></screen>
+</command> : This command ensures that all plugins are located under
-This command ensures that all plugins are located under
 <filename>/usr/lib/xmms/Plugins</filename>.</para>
 </sect2>
 

multimedia/audioutils/xmms/xmms-inst.xml

@@ -1,11 +1,11 @@
 <sect2>
-<title>Installation of XMMS</title>
+<title>Installation of <application>XMMS</application></title>
 
-<para>Install XMMS by running the following commands:</para>
+<para>Install <application>XMMS</application> by running the following commands:
+</para>
 
-<para><screen><userinput>./configure --prefix=/usr \
+<screen><userinput><command>./configure --prefix=/usr --enable-one-plugin-dir &amp;&amp;
---enable-one-plugin-dir &amp;&amp;</userinput>
+make &amp;&amp;
-<userinput>make &amp;&amp;</userinput>
+make install</command></userinput></screen>
-<userinput>make install</userinput></screen></para>
 </sect2>
 

multimedia/audioutils/xmms/xmms-intro.xml

@@ -1,17 +1,31 @@
 <sect2>
-<title>Introduction to XMMS</title>
+<title>Introduction to <application>XMMS</application></title>
 
-<screen>Download location (HTTP):       <ulink url="&XMMS-download-http;"/>
+<para><application>XMMS</application> is an audio player for the
-Download location (FTP):        <ulink url="&XMMS-download-ftp;"/>
+<application>X</application> Window System. </para>
-Version used:                   &XMMS-version;
-Package size:                   &XMMS-size;
-Estimated Disk space required:  &XMMS-buildsize;</screen>
 
-<para>XMMS is an audio player for the X Window System. </para>
+<sect3><title>Package information</title>
+<itemizedlist spacing='compact'>
+<listitem><para>Download (HTTP): <ulink
+url="&XMMS-download-http;"/></para></listitem>
+<listitem><para>Download (FTP): <ulink
+url="&XMMS-download-ftp;"/></para></listitem>
+<listitem><para>Download size: &XMMS-size;</para></listitem>
+<listitem><para>Estimated Disk space required:
+&XMMS-buildsize;</para></listitem>
+<listitem><para>Estimated build time:
+&XMMS-time;</para></listitem></itemizedlist>
+</sect3>
+                                                                                
+<sect3><title><application>XMMS</application> dependencies</title>
+<sect4><title>Required</title>
+<para>a working soundcard, <xref linkend="xfree86"/>, <xref
+linkend="GTK"/> and <xref linkend="GLib"/></para></sect4>
+<sect4><title>Optional</title>
+<para><xref linkend="esound"/>, <xref linkend="gnome-libs"/>,
+gnome-applets, libmikmod,
+<xref linkend="libogg"/>, <xref linkend="libvorbis"/> and <xref
+linkend="libxml"/></para></sect4>
+</sect3>
 
-<screen>XMMS depends on:
-a working soundcard, <xref linkend="xfree86"/>, <xref linkend="GTK"/> and <xref linkend="GLib"/>
-XMMS will utilize:
-<xref linkend="esound"/>, <xref linkend="gnome-libs"/>, gnome-applets, libmikmod, 
-<xref linkend="libogg"/>, <xref linkend="libvorbis"/> and <xref linkend="libxml"/></screen>
 </sect2>

multimedia/audioutils/xmms/xmms.ent

@@ -9,4 +9,4 @@
 <!ENTITY XMMS-download-http "http://www.xmms.org/files/1.2.x/xmms-1.2.7.tar.bz2">
 <!ENTITY XMMS-download-ftp "ftp://ftp.xmms.org/xmms/1.2.x/xmms-1.2.7.tar.bz2">
 <!ENTITY XMMS-size "11 MB">
-<!ENTITY XMMS-time "2 SBU">
+<!ENTITY XMMS-time "1.0 SBU">