Updated to MPlayer-1.0pre6a, also added indexing tags to package instructions

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@3319 af4574ff-66df-0310-9fd7-8a98e5e911e0
This commit is contained in:
Randy McMurchy 2005-01-20 05:06:50 +00:00
parent 380902230b
commit ec2270fc21
4 changed files with 99 additions and 45 deletions

View File

@ -1,4 +1,4 @@
<!ENTITY day "19">
<!ENTITY day "20">
<!ENTITY month "01">
<!ENTITY year "2005">
<!ENTITY version "svn-&year;&month;&day;">
@ -459,7 +459,7 @@
<!-- Chapter 39 -->
<!ENTITY ffmpeg-version "0.4.9-pre1">
<!ENTITY avifile-version "0.7.41">
<!ENTITY mplayer-version "1.0pre6">
<!ENTITY mplayer-version "1.0pre6a">
<!ENTITY xine-ui-version "0.99.2">
<!ENTITY transcode-version "0.6.14">

View File

@ -22,6 +22,9 @@ who wrote what.</para>
<itemizedlist>
<listitem><para>January 20th, 2005 [randy]: Updated to
MPlayer-1.0pre6a.</para></listitem>
<listitem><para>January 19th, 2005 [randy]: Added installation of
HTML documentation to the FFmpeg instructions; added commands to create
symlinks to the moved libstdc++ library in the GCC3

View File

@ -5,21 +5,24 @@
<!ENTITY mplayer-download-http "http://www1.mplayerhq.hu/MPlayer/releases/MPlayer-&mplayer-version;.tar.bz2">
<!ENTITY mplayer-download-ftp "ftp://ftp1.mplayerhq.hu/MPlayer/releases/MPlayer-&mplayer-version;.tar.bz2">
<!ENTITY mplayer-size "5.6 MB">
<!ENTITY mplayer-buildsize "82 MB (additional 22 MB for essential CODECs)">
<!ENTITY mplayer-time "2.18 SBU">
<!ENTITY mplayer-md5sum "a812d945b884c2e2fa7f90c57cd76bff">
<!ENTITY mplayer-size "6.3 MB">
<!ENTITY mplayer-buildsize "93.5 MB (additional 22 MB for essential CODECs)">
<!ENTITY mplayer-time "2.19 SBU">
<!ENTITY mplayer-default-codec "essential-20041107.tar.bz2">
<!ENTITY mplayer-default-skin "Blue-1.4.tar.bz2">
<!ENTITY mplayer-default-font "font-arial-iso-8859-1">
]>
<sect1 id="mplayer" xreflabel="MPlayer-&mplayer-version;">
<sect1 id="mplayer-package" xreflabel="MPlayer-&mplayer-version;">
<sect1info>
<othername>$LastChangedBy$</othername>
<date>$Date$</date>
</sect1info>
<?dbhtml filename="mplayer.html"?>
<title><application>MPlayer</application>-&mplayer-version;</title>
<indexterm zone="mplayer-package">
<primary sortas="a-MPlayer">MPlayer</primary></indexterm>
<sect2>
<title>Introduction to <application>MPlayer</application></title>
@ -44,6 +47,7 @@ output devices supported by <application>MPlayer</application>, visit the
<ulink url="&mplayer-download-http;"/></para></listitem>
<listitem><para>Download (FTP):
<ulink url="&mplayer-download-ftp;"/></para></listitem>
<listitem><para>Download MD5 sum: &mplayer-md5sum;</para></listitem>
<listitem><para>Download size: &mplayer-size;</para></listitem>
<listitem><para>Estimated disk space required:
&mplayer-buildsize;</para></listitem>
@ -162,10 +166,10 @@ and <ulink url="http://www.lirc.org/">LIRC</ulink></para>
(which can provide support for additional audio and video formats such as
Real, Indeo and QuickTime), extract them to
<filename class="directory">/usr/lib/mplayer/codecs</filename>
using the following commands (substitute and/or add different
using the following commands as the root user (substitute and/or add different
<acronym>CODEC</acronym> filenames, if necessary):</para>
<screen><userinput><command>install -d -m755 /usr/lib/mplayer/codecs &amp;&amp;
<screen><userinput role='root'><command>install -d -m755 /usr/lib/mplayer/codecs &amp;&amp;
tar -jxf ../&mplayer-default-codec; \
-C /usr/lib/mplayer/codecs --strip-path=1 &amp;&amp;
chown -R root:root /usr/lib/mplayer/codecs</command></userinput></screen>
@ -182,9 +186,9 @@ to the <command>configure</command> script.</para>
<application>MPlayer</application> (requires <xref linkend="GTK"/>), add
<option>--enable-gui</option> to the <command>configure</command>
script. You'll also need to extract at least one skin. Extract the desired
skin and create the default location:</para>
skin and create the default location (as the root user):</para>
<screen><userinput><command>install -v -d -m755 /usr/share/mplayer/Skin &amp;&amp;
<screen><userinput role='root'><command>install -v -d -m755 /usr/share/mplayer/Skin &amp;&amp;
tar -jxf ../&mplayer-default-skin; \
-C /usr/share/mplayer/Skin &amp;&amp;
chown -v -R root:root /usr/share/mplayer/Skin/Blue &amp;&amp;
@ -214,8 +218,11 @@ commands:</para>
<screen><userinput><command>patch -Np1 -i ../MPlayer-&mplayer-version;-kernel_2.6-1.patch &amp;&amp;
./configure --prefix=/usr --confdir=/etc/mplayer \
--enable-largefiles &amp;&amp;
make &amp;&amp;
make install &amp;&amp;
make</command></userinput></screen>
<para>Now, as the root user:</para>
<screen><userinput role='root'><command>make install &amp;&amp;
install -d -m755 /usr/share/doc/mplayer &amp;&amp;
cp -R DOCS/* /usr/share/doc/mplayer</command></userinput></screen>
@ -227,7 +234,7 @@ shared library, add <option>--enable-shared-pp</option> to the
<command>configure</command> script, then execute the following command after
the commands above:</para>
<screen><userinput><command>make -C libavcodec/libpostproc install</command></userinput></screen>
<screen><userinput role='root'><command>make -C libavcodec/libpostproc install</command></userinput></screen>
<para>You will need <filename>codecs.conf</filename> only if you want to
change its properties, as the main binary contains an internal copy of
@ -236,13 +243,13 @@ the desired results, as incorrect entries in this file have been known to
cause errors and render the player unusable. If necessary, create the file
using the following command.</para>
<screen><userinput><command>install -m644 etc/codecs.conf /etc/mplayer</command></userinput></screen>
<screen><userinput role='root'><command>install -m644 etc/codecs.conf /etc/mplayer</command></userinput></screen>
<para>You may also want to copy all the default configuration files to
<filename class='directory'>/etc/mplayer</filename> for future reference or
more customization ability.</para>
<screen><userinput><command>install -m644 etc/*.conf /etc/mplayer</command></userinput></screen>
<screen><userinput role='root'><command>install -m644 etc/*.conf /etc/mplayer</command></userinput></screen>
</sect3>
<sect3>
@ -265,7 +272,7 @@ ln -sf /usr/X11R6/lib/X11/fonts/TTF/luxisri.ttf \
prerendered <application>MPlayer</application> font package, extract and link
one of the font tarballs using the following commands:</para>
<screen><userinput><command>tar -jxf ../&mplayer-default-font;.tar.bz2 \
<screen><userinput role='root'><command>tar -jxf ../&mplayer-default-font;.tar.bz2 \
-C /usr/share/mplayer/font &amp;&amp;
chown -R root:root /usr/share/mplayer/font &amp;&amp;
cd /usr/share/mplayer/font &amp;&amp;
@ -286,7 +293,7 @@ url="http://www.mplayerhq.hu/DOCS/HTML/en/subosd.html#mpsub-install"/>.</para>
from your <acronym>DVD</acronym> drive to <filename>/dev/dvd</filename>. If
necessary, create the link using the following commands:</para>
<screen><userinput><command>cat &gt;&gt; /etc/udev/rules.d/24-dvd.rules &lt;&lt; "EOF"</command>
<screen><userinput role='root'><command>cat &gt;&gt; /etc/udev/rules.d/24-dvd.rules &lt;&lt; "EOF"</command>
# Create a /dev/dvd symlink
KERNEL="<replaceable>[dvd drive]</replaceable>", SYMLINK="dvd"
@ -311,9 +318,13 @@ ATAPI CD/DVD-ROM drive</userinput></screen>
<sect2>
<title>Configuring <application>MPlayer</application></title>
<sect3><title>Config files</title>
<sect3 id="mplayer-config"><title>Config files</title>
<para><filename>/etc/mplayer/*</filename>,
<filename>~/.mplayer/*</filename></para>
<indexterm zone="mplayer-package mplayer-config">
<primary sortas="e-AA.mplayer">~/.mplayer/*</primary></indexterm>
<indexterm zone="mplayer-package mplayer-config">
<primary sortas="e-etc-mplayer">/etc/mplayer/*</primary></indexterm>
</sect3>
<sect3><title>Configuration information</title>
@ -323,7 +334,7 @@ directory is empty unless you copied the default files as mentioned above).
Configuration can be accomplished by choosing the configuration button located
on the <application>MPlayer</application> <acronym>GUI</acronym>. Any
configuration changes made here will be copied to the user's
<filename>~/.mplayer</filename> directory.</para>
<filename class='directory'>~/.mplayer</filename> directory.</para>
</sect3>
</sect2>
@ -331,45 +342,64 @@ configuration changes made here will be copied to the user's
<sect2>
<title>Contents</title>
<para>The <application>MPlayer</application> package contains
<command>mplayer</command>,
<command>gmplayer</command> and
<command>mencoder</command>.</para>
<segmentedlist>
<segtitle>Installed Programs</segtitle>
<segtitle>Installed Libraries</segtitle>
<segtitle>Installed Directories</segtitle>
<seglistitem>
<seg>gmplayer, mplayer and mencoder</seg>
<seg>libdha.so and optionally, libpostproc.so</seg>
<seg>/etc/mplayer, /usr/lib/mplayer, /usr/share/mplayer and
/usr/share/doc/mplayer</seg>
</seglistitem>
</segmentedlist>
</sect2>
<variablelist>
<bridgehead renderas="sect3">Short Descriptions</bridgehead>
<?dbfo list-presentation="list"?>
<sect2><title>Description</title>
<varlistentry id="gmplayer">
<term><command>gmplayer</command></term>
<listitem><para>is a symlink to <command>mplayer</command> which brings up
the graphical user interface component of
<application>MPlayer</application>.</para>
<indexterm zone="mplayer-package gmplayer">
<primary sortas="b-gmplayer">gmplayer</primary></indexterm>
</listitem>
</varlistentry>
<sect3><title>mplayer</title>
<para><command>mplayer</command> manages the input formats, the
<acronym>CODEC</acronym>s and the output formats to play video files,
<acronym>DVD</acronym>s, (S)<acronym>VCD</acronym>s or network streams
containing audio and/or video information on your system.</para>
<varlistentry id="mplayer">
<term><command>mplayer</command></term>
<listitem><para> manages the input formats, the <acronym>CODEC</acronym>s and
the output formats to play video files, <acronym>DVD</acronym>s,
(S)<acronym>VCD</acronym>s or network streams containing audio and/or video
information on your system.</para>
<indexterm zone="mplayer-package mplayer">
<primary sortas="b-mplayer">mplayer</primary></indexterm>
<para>Examples:</para>
<screen><command>mplayer -fs blfs.avi
<screen><userinput><command>mplayer -fs blfs.avi
mplayer -vo fbdev -fb /dev/fb0 dvd://1 -aid 128 -sub en -framedrop
mplayer -fs vcd://1 # works both for VCDs and SVCDs
mplayer http://www.students.uni-marburg.de/~Klossa/hapkidofight_lo.mpg</command></screen>
mplayer http://www.students.uni-marburg.de/~Klossa/hapkidofight_lo.mpg</command></userinput></screen>
<para>For further information, look at the very good documentation included
with the package in the source tree subdirectory
<filename class="directory">DOCS</filename> (also installed at
<filename class='directory'>/usr/share/doc/mplayer</filename>).</para>
</sect3>
</listitem>
</varlistentry>
<sect3><title>gmplayer</title>
<para><command>gmplayer</command> is a symlink to
<command>mplayer</command> which brings up the graphical user
interface component of <application>MPlayer</application>.</para></sect3>
<sect3><title>mencoder</title>
<para><command>mencoder</command> is used to encode any
<application>MPlayer</application> playable movie to DivX4,
<application>XviD</application> or any <acronym>CODEC</acronym> in
<varlistentry id="mencoder">
<term><command>mencoder</command></term>
<listitem><para>is used to encode any <application>MPlayer</application>
playable movie to DivX4, <application>XviD</application> or any
<acronym>CODEC</acronym> in
<filename class='libraryfile'>libavcodec</filename> with
<acronym>PCM</acronym>/MP3/VBRMP3 audio.</para>
<indexterm zone="mplayer-package mencoder">
<primary sortas="b-mencoder">mencoder</primary></indexterm>
<para>Example:</para>
@ -387,7 +417,28 @@ mencoder -dvd 1 -aid 128 -ovc frameno -oac mp3lame \
mencoder -dvd 1 -aid 128 -oac copy -ovc lavc \
-lavcopts vcodec=mpeg4:vpass=2:vhq:vbitrate=&lt;bitrate&gt; -o &lt;name.avi&gt;
mencoder -forceidx &lt;name.avi&gt;</command></userinput></screen>
</sect3>
</listitem>
</varlistentry>
<varlistentry id="libdha">
<term><filename class='libraryfile'>libdha.so</filename></term>
<listitem><para>contains functions used by the
<application>MPlayer</application> programs.</para>
<indexterm zone="mplayer-package libdha">
<primary sortas="c-libdha">libdha.so</primary></indexterm>
</listitem>
</varlistentry>
<varlistentry id="libpostproc">
<term><filename class='libraryfile'>libpostproc.so</filename></term>
<listitem><para>is a post-processing filter library used by the
<application>MPlayer</application> programs and other packages.</para>
<indexterm zone="mplayer-package libpostproc">
<primary sortas="c-libpostproc">libpostproc.so</primary></indexterm>
</listitem>
</varlistentry>
</variablelist>
</sect2>

View File

@ -96,8 +96,8 @@ url="&patch-root;/transcode-&transcode-version;-gcc34-1.patch"/></para>
<ulink url="http://loci.cs.utk.edu/">LoRS/IBP</ulink></para>
<para>Though <application>Transcode</application> has no compile-time
requirement for <xref linkend="mplayer"/>'s shared post-processing library,
<application>Transcode</application> can use it at run-time.</para>
requirement for <xref linkend="mplayer-package"/>'s shared post-processing
library, <application>Transcode</application> can use it at run-time.</para>
</sect4>
</sect3>