Add <systemitem class="library"> tags to libavcodec and a few others.

git-svn-id: svn://svn.mplayerhq.hu/mplayer/trunk@11823 b3059339-0415-0410-9bf9-f77b7e298cf2

8 files changed, 81 insertions, 47 deletions

diff --git a/DOCS/xml/en/codecs.xml b/DOCS/xml/en/codecs.xml
index 8c13a0201f..aec9a933bd 100644
--- a/DOCS/xml/en/codecs.xml
+++ b/DOCS/xml/en/codecs.xml
@@ -56,7 +56,8 @@ The most important ones above all:
   FLI/FLC
   </simpara></listitem>
 <listitem><simpara>
-  <emphasis role="bold">RealVideo 1.0 &amp; 2.0</emphasis> from libavcodec, and
+  <emphasis role="bold">RealVideo 1.0 &amp; 2.0</emphasis> from
+  <systemitem class="library">libavcodec</systemitem>, and
   <emphasis role="bold">RealVideo 3.0 &amp; 4.0</emphasis> codecs using RealPlayer
   libraries
   </simpara></listitem>
@@ -91,9 +92,10 @@ for all file types.
 <para>
 The new generation of this codec is called DivX4 and can even decode
 movies made with the infamous DivX codec! In addition it is much faster
-than the native Win32 DivX DLLs but slower than <systemitem
-class="library">libavcodec</systemitem>.  Hence its usage as a decoder is
-<emphasis role="bold">DISCOURAGED</emphasis>. However, it is useful for
+than the native Win32 DivX DLLs but slower than
+<systemitem class="library">libavcodec</systemitem>.
+Hence its usage as a decoder is
+<emphasis role="bold">discouraged</emphasis>. However, it is useful for
 encoding. One disadvantage of this codec is that it is not available under an
 Open Source license.
 </para>
@@ -219,9 +221,11 @@ and <ulink url="http://www.ffmpeg.org/ffmpeg-doc.html#SEC20">audio</ulink> codec
 </para>
 
 <para>
-If you use an <application>MPlayer</application> release you have libavcodec
+If you use an <application>MPlayer</application> release you have
+<systemitem class="library">libavcodec</systemitem>
 right in the package, just build  as usual. If you use
-<application>MPlayer</application> from CVS you have to extract libavcodec from
+<application>MPlayer</application> from CVS you have to extract
+<systemitem class="library">libavcodec</systemitem> from
 the FFmpeg CVS tree as FFmpeg releases are very rare. The CVS is mostly stable
 and offers the most features. In order to achieve this do:
 </para>
@@ -243,7 +247,8 @@ and offers the most features. In order to achieve this do:
   copy/move it!
   </para></step>
 <step><para>
-  If you prefer having libavcodec updated at the same time you update
+  If you prefer having <systemitem class="library">libavcodec</systemitem>
+  updated at the same time you update
   <application>MPlayer</application> CVS, put the following line into the
   <filename>main/CVS/Entries</filename> file:
   <screen>D/libavcodec////</screen>
@@ -258,7 +263,8 @@ and offers the most features. In order to achieve this do:
 <para>
 <application>MPlayer</application> from CVS does contain a
 <filename>libavcodec</filename> subdirectory, but it does
-<emphasis role="bold">not</emphasis> contain the source for libavcodec!
+<emphasis role="bold">not</emphasis> contain the source for
+<systemitem class="library">libavcodec</systemitem>!
 You must follow the steps above to obtain the source for this library.
 </para>
 </note>
@@ -457,7 +463,8 @@ then started XviD. So both projects have the same origin.
 <title>DISADVANTAGES</title>
 <listitem><simpara>
   currently it does not properly <emphasis role="bold">decode</emphasis> all
-  DivX/DivX4 files (no problem as <link linkend="ffmpeg">libavcodec</link>
+  DivX/DivX4 files (no problem as
+  <link linkend="ffmpeg"><systemitem class="library">libavcodec</systemitem></link>
   can play them)
   </simpara></listitem>
 <listitem><simpara>
@@ -519,12 +526,12 @@ decoders:
 <listitem><simpara>
   Sorenson Video v1 (fourcc <emphasis>SVQ1</emphasis>) - decoding supported
   by <emphasis role="bold">native codec</emphasis>
-  (<link linkend="ffmpeg">libavcodec</link>)
+  (<link linkend="ffmpeg"><systemitem class="library">libavcodec</systemitem></link>)
   </simpara></listitem>
 <listitem><simpara>
   Sorenson Video v3 (fourcc <emphasis>SVQ3</emphasis>) - decoding supported by
   <emphasis role="bold">native codec</emphasis>
-  (<link linkend="ffmpeg">libavcodec</link>)
+  (<link linkend="ffmpeg"><systemitem class="library">libavcodec</systemitem></link>)
   </simpara></listitem>
 </itemizedlist>
 
@@ -557,7 +564,7 @@ decoders:
   </simpara></listitem>
 <listitem><simpara>
   Windows Media Audio 7 and 8 (aka WMAv1 and WMAv2) (<emphasis role="bold">native</emphasis> code, with
-  <link linkend="ffmpeg">libavcodec</link>)
+  <link linkend="ffmpeg"><systemitem class="library">libavcodec</systemitem></link>)
   </simpara></listitem>
 <listitem><simpara>
   Windows Media Audio 9 (WMAv3) (using DMO DLL)
diff --git a/DOCS/xml/en/documentation.xml b/DOCS/xml/en/documentation.xml
index 712685728e..5b9c60a44b 100644
--- a/DOCS/xml/en/documentation.xml
+++ b/DOCS/xml/en/documentation.xml
@@ -92,7 +92,8 @@ Encoder) is a simple movie encoder, designed to encode
 (<emphasis role="bold">AVI/ASF/OGG/DVD/VCD/VOB/MPG/MOV/VIV/FLI/RM/NUV/NET/PVA</emphasis>)
 to other <application>MPlayer</application>-playable formats (see below). It
 can encode with various codecs, like <emphasis role="bold">DivX4</emphasis>
-(1 or 2 passes), libavcodec, <emphasis role="bold">PCM/MP3/VBR MP3</emphasis>
+(1 or 2 passes), <systemitem class="library">libavcodec</systemitem>,
+<emphasis role="bold">PCM/MP3/VBR MP3</emphasis>
 audio. Also has powerful plugin system for video manipulation.
 </para>
 
@@ -104,8 +105,8 @@ audio. Also has powerful plugin system for video manipulation.
   <application>MPlayer</application>
   </simpara></listitem>
 <listitem><simpara>
-  Encoding to all the codecs of ffmpeg's <link
-  linkend="ffmpeg">libavcodec</link>
+  Encoding to all the codecs of FFmpeg's
+  <link linkend="ffmpeg"><systemitem class="library">libavcodec</systemitem></link>
   </simpara></listitem>
 <listitem><simpara>
   Video encoding from <emphasis role="bold">V4L compatible TV tuners</emphasis>
diff --git a/DOCS/xml/en/faq.xml b/DOCS/xml/en/faq.xml
index 534c8da5dd..7e7ae6fa85 100644
--- a/DOCS/xml/en/faq.xml
+++ b/DOCS/xml/en/faq.xml
@@ -549,10 +549,12 @@ You use a vo driver with single buffering (x11,xv). With xv, use the
 
 <qandaentry>
 <question><para>
-What exactly is this libavcodec thing?
+What exactly is this <systemitem class="library">libavcodec</systemitem> thing?
 </para></question>
 <answer><para>
-See the <link linkend="ffmpeg">libavcodec</link> section.
+See the
+<link linkend="ffmpeg"><systemitem class="library">libavcodec</systemitem></link>
+section.
 </para></answer>
 </qandaentry>
 
@@ -562,8 +564,10 @@ But configure tells me
 <screen>Checking for libavcodec ... no</screen>
 </para></question>
 <answer><para>
-You need to get libavcodec from FFmpeg's CVS. Read the instructions in the
-<link linkend="ffmpeg">libavcodec</link> section.
+You need to get <systemitem class="library">libavcodec</systemitem> from
+FFmpeg's CVS. Read the instructions in the
+<link linkend="ffmpeg"><systemitem class="library">libavcodec</systemitem></link>
+section.
 </para></answer>
 </qandaentry>
 
diff --git a/DOCS/xml/en/install.xml b/DOCS/xml/en/install.xml
index 89302a6e7e..28eaf56f03 100644
--- a/DOCS/xml/en/install.xml
+++ b/DOCS/xml/en/install.xml
@@ -126,7 +126,8 @@ You need a fairly recent system. On Linux, 2.4.x kernels are recommended.
 
 <itemizedlist>
 <listitem><para>
-  <emphasis role="bold">libavcodec</emphasis>: This codec package is capable
+  <emphasis role="bold"><systemitem class="library">libavcodec</systemitem></emphasis>:
+  This codec package is capable
   of decoding H263/MJPEG/RV10/DivX3/DivX4/DivX5/MP41/MP42/WMV1/WMV2/SVQ1/SVQ3 encoded video
   streams and WMA (Windows Media Audio) v1/v2 audio streams, on multiple
   platforms. It is also known to be the fastest for this task. See
@@ -169,7 +170,9 @@ You need a fairly recent system. On Linux, 2.4.x kernels are recommended.
   <listitem><simpara>
     Not needed for old ASF's with MP41 or MP42 video (though VoxWare audio is
     frequent for these files - it's done by the Win32 codec), or WMV7. Also not
-    needed for WMA (Windows Media Audio), libavcodec has opensource decoder for that.
+    needed for WMA (Windows Media Audio),
+    <systemitem class="library">libavcodec</systemitem> has open source decoder
+    for that.
     </simpara></listitem>
   </itemizedlist>
   </para></listitem>
@@ -182,8 +185,9 @@ You need a fairly recent system. On Linux, 2.4.x kernels are recommended.
 <listitem><para>
   <emphasis role="bold">DivX4/DivX5</emphasis>: information about this codec is
   available in the <link linkend="divx4-5">DivX4/DivX5</link> section. You possibly
-  don't want this codec as <emphasis role="bold">libavcodec</emphasis> (see
-  above) is much faster and has better quality than this, for both decoding
+  don't want this codec as
+  <emphasis role="bold"><systemitem class="library">libavcodec</systemitem></emphasis>
+  (see above) is much faster and has better quality than this, for both decoding
   and encoding. Features:
   <itemizedlist>
   <listitem><simpara>
@@ -192,7 +196,8 @@ You need a fairly recent system. On Linux, 2.4.x kernels are recommended.
     </simpara></listitem>
   <listitem><simpara>
     can play old <emphasis role="bold">DivX3</emphasis> movies much faster than
-    the Win32 DLL but slower than <emphasis role="bold">libavcodec</emphasis>!
+    the Win32 DLL but slower than
+    <emphasis role="bold"><systemitem class="library">libavcodec</systemitem></emphasis>!
     </simpara></listitem>
   <listitem><simpara>
     it's closed-source, and only a x86 version is available.
diff --git a/DOCS/xml/en/mencoder.xml b/DOCS/xml/en/mencoder.xml
index cfb5d19377..a9b2043d3b 100644
--- a/DOCS/xml/en/mencoder.xml
+++ b/DOCS/xml/en/mencoder.xml
@@ -109,7 +109,8 @@ mencoder dvd://2 -ovc lavc -lavcopts vcodec=mpeg4:vpass=2 -oac copy -o <replacea
 <title>Encoding to MPEG format</title>
 <para>
 <application>MEncoder</application> can create MPEG (MPEG-PS) format output
-files. It's probably useful only with <link linkend="ffmpeg">libavcodec</link>'s
+files. It's probably useful only with
+<link linkend="ffmpeg"><systemitem class="library">libavcodec</systemitem></link>'s
 <emphasis>mpeg1video</emphasis> codec, because players - except
 <application>MPlayer</application> - expect MPEG1 video, and MPEG1 layer 2 (MP2)
 audio streams in MPEG files.
@@ -234,11 +235,12 @@ must not be broken. You may need to fix your input AVI files first, as described
 </sect1>
 
 <sect1 id="menc-feat-enc-libavcodec">
-<title>Encoding with the libavcodec codec family</title>
+<title>Encoding with the <systemitem class="library">libavcodec</systemitem>
+  codec family</title>
 
 <para>
-<link linkend="ffmpeg">libavcodec</link> provides simple encoding to a lot
-of interesting video and audio formats.
+<link linkend="ffmpeg"><systemitem class="library">libavcodec</systemitem></link>
+provides simple encoding to a lot of interesting video and audio formats.
 You can encode to the following codecs (more or less up to date):
 
 <informaltable frame="all">
@@ -485,7 +487,8 @@ attribute of MPEG4, except <application>MPlayer</application>.
 </para>
 
 <para>
-This feature can be used only with <link linkend="ffmpeg">libavcodec</link>'s
+This feature can be used only with
+<link linkend="ffmpeg"><systemitem class="library">libavcodec</systemitem></link>'s
 <systemitem>mpeg4</systemitem> codec. Keep in mind: although
 <application>MPlayer</application> will correctly play the created file,
 other players will use the wrong aspect ratio.
@@ -506,9 +509,10 @@ Usage
 <sect1 id="custommatrices"><title>Custom inter/intra matrices</title>
 
 <para>
-With this feature of <link linkend="ffmpeg">libavcodec</link> you are
-able to set custom inter (I-frames/key frames) and intra (P-frames/predicted
-frames) matrices. It is supported by many of the codecs:
+With this feature of
+<link linkend="ffmpeg"><systemitem class="library">libavcodec</systemitem></link>
+you are able to set custom inter (I-frames/key frames) and intra
+(P-frames/predicted frames) matrices. It is supported by many of the codecs:
 <systemitem>mpeg1video</systemitem> and <systemitem>mpeg2video</systemitem>
 are reported as working.
 </para>
@@ -575,7 +579,8 @@ vcodec=mpeg2video:intra_matrix=8,9,12,22,26,27,29,34,9,10,14,26,27,29,34,37,
   Ripping a DVD title into a maximally high quality MPEG4 (DivX) file
   involves many considerations. Below is an example of the process when
   there is no file size goal (other than perhaps fitting the result into 2GB).
-  <systemitem class="library">libavcodec</systemitem> will be used for the video,
+  <systemitem class="library"><systemitem class="library">libavcodec</systemitem></systemitem>
+  will be used for the video,
   and the audio will be copied as is without any changes.
 </para>
 
@@ -602,8 +607,8 @@ vcodec=mpeg2video:intra_matrix=8,9,12,22,26,27,29,34,9,10,14,26,27,29,34,37,
   quantizing AKA constant quality is a good choice. That way each frame
   is given as much bits as its needs to keep the quality at the desired
   level, but multiple encoding passes are not needed. With
-  <systemitem class="library">libavcodec</systemitem>, you get constant
-  quality by using
+  <systemitem class="library"><systemitem class="library">libavcodec</systemitem></systemitem>,
+  you get constant quality by using
   <option>-lavcopts vqscale=<replaceable>N</replaceable></option>.
   <option>vqscale=3</option> should give you a file below 2GB in size,
   depending mainly on the movie length and video noisiness (the more
diff --git a/DOCS/xml/en/ports.xml b/DOCS/xml/en/ports.xml
index d8b6b401ac..637eaf7205 100644
--- a/DOCS/xml/en/ports.xml
+++ b/DOCS/xml/en/ports.xml
@@ -55,11 +55,12 @@ get working RPMs from
 Compaq Ipaq. The easiest way to obtain <application>MPlayer</application> is to get it
 from one of the <ulink url="http://www.openzaurus.org">OpenZaurus</ulink> package feeds. If
 you want to compile it yourself, you should look at the
-<ulink url="http://openzaurus.bkbits.net:8080/buildroot/src/packages/mplayer?nav=index.html|src/.|src/packages">MPlayer</ulink>
+<ulink url="http://openzaurus.bkbits.net:8080/buildroot/src/packages/mplayer?nav=index.html|src/.|src/packages">mplayer</ulink>
 and the
 <ulink url="http://openzaurus.bkbits.net:8080/buildroot/src/packages/libavcodec?nav=index.html|src/.|src/packages">libavcodec</ulink>
 directory in the OpenZaurus distribution buildroot. These always have the latest
-Makefile and patches used for building a CVS <application>MPlayer</application> with libavcodec.
+Makefile and patches used for building a CVS <application>MPlayer</application> with
+<systemitem class="library">libavcodec</systemitem>.
 If you need a GUI frontend, you can use xmms-embedded.
 </para>
 </sect2>
@@ -128,10 +129,14 @@ See the <link linkend="macos">Mac OS</link> section.
 <para>
 On <emphasis role="bold">UltraSPARCs</emphasis>, <application>MPlayer</application>
 takes advantage of their <emphasis role="bold">VIS</emphasis> extensions
-(equivalent to MMX), currently only in <emphasis>libmpeg2</emphasis>, <emphasis>libvo</emphasis>
-and <emphasis>libavcodec</emphasis>, but not in mp3lib. You can watch a VOB file
+(equivalent to MMX), currently only in
+<systemitem class="library">libmpeg2</systemitem>,
+<systemitem class="library">libvo</systemitem>
+and <systemitem class="library">libavcodec</systemitem>, but not in
+<systemitem class="library">mp3lib</systemitem>. You can watch a VOB file
 on a 400MHz CPU. You'll need
-<ulink url="http://www.sun.com/sparc/vis/mediaLib.html">mLib</ulink> installed.
+<ulink url="http://www.sun.com/sparc/vis/mediaLib.html"><systemitem class="library">mLib</systemitem></ulink>
+installed.
 </para>
 
 <para>
@@ -386,7 +391,8 @@ Mac OS versions and send patches!
 
 <para>
 Apple's modified GCC 3.x is preferred for compiling
-<application>MPlayer</application> especially when using libavcodec as Apple's
+<application>MPlayer</application> especially when using
+<systemitem class="library">libavcodec</systemitem> as Apple's
 modified GCC 2.95.x doesn't support C99 syntax well.
 </para>
 
diff --git a/DOCS/xml/en/tvinput.xml b/DOCS/xml/en/tvinput.xml
index 556da1d3e8..897886f712 100644
--- a/DOCS/xml/en/tvinput.xml
+++ b/DOCS/xml/en/tvinput.xml
@@ -107,7 +107,8 @@ In the older versions of <application>MPlayer</application>/
 <application>MEncoder</application> it was necessary to specify the output
 format. This issue should be fixed in the current releases and <option>outfmt</option>
 isn't required anymore, and the default suits the most purposes. For example,
-if you are capturing into DivX using libavcodec and specify
+if you are capturing into DivX using
+<systemitem class="library">libavcodec</systemitem> and specify
 <option>outfmt=RGB24</option> in order to increase the quality of the captured
 images, the captured image will be actually later converted back into YV12 so
 the only thing you achieve is a massive waste of CPU power.
diff --git a/DOCS/xml/en/video.xml b/DOCS/xml/en/video.xml
index c8d673a0ed..d946c3673d 100644
--- a/DOCS/xml/en/video.xml
+++ b/DOCS/xml/en/video.xml
@@ -1513,9 +1513,11 @@ There's a relatively new nVidia driver out there, it's known to work on Riva
 <listitem><para>
   Currently only codecs capable of UYVY colorspace output
   can work in conjunction with this driver. Unfortunately, this excludes
-  every single decoder from the libavcodec family. This leaves us with the
-  following usable popular codecs: <systemitem>cvid, divxds, xvid, divx4,
-  wmv7, wmv8</systemitem> and some others. Please note that this is only
+  every single decoder from the
+  <systemitem class="library">libavcodec</systemitem> family. This leaves
+  us with the following usable popular codecs:
+  <systemitem>cvid, divxds, xvid, divx4, wmv7, wmv8</systemitem> and some
+  others. Please note that this is only
   a temporal inconvenience. The usage syntax is as follows:
   <screen>
     mplayer -vf format=uyvy -vc divxds <replaceable>divx3file.avi</replaceable>
@@ -1944,7 +1946,9 @@ This does not work with digital audio output (<option>-ac hwac3</option>).
 <term><option>-vf lavc/fame</option></term>
 <listitem><para>
 To watch non-MPEG content on the em8300 (i.e. DivX or RealVideo) you have to
-specify an MPEG1 video filter such as libavcodec (lavc) or libfame (fame). At
+specify an MPEG1 video filter such as
+<systemitem class="library">libavcodec</systemitem> (lavc) or
+<systemitem class="library">libfame</systemitem> (fame). At
 the moment lavc is both faster and gives better image quality, it is suggested
 that you use that unless you have problems with it. See the man page for further
 info about <option>-vf lavc/fame</option>.
@@ -1993,7 +1997,8 @@ it must be used to specify the DXR3's output instead of a soundcard.
 This is a display-driver (<option>-vo zr</option>) for a number of MJPEG
 capture/playback cards (tested for DC10+ and Buz, and it should work for the
 LML33, the DC10). The driver works by encoding the frame to JPEG and then
-sending it to the card. For the JPEG encoding <systemitem>libavcodec</systemitem>
+sending it to the card. For the JPEG encoding
+<systemitem class="library">libavcodec</systemitem>
 is used, and required. With the special <emphasis>cinerama</emphasis> mode,
 you can watch movies in true wide screen provided that you have two beamers
 and two MJPEG cards. Depending on resolution and quality settings, this driver