Moved RealPlayer libs installation to codecs.html where all the other

installation instructions are.
Always use <B>Note:</> for consistency, reworded parts all over the place.


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

DOCS/codecs.html

@@ -60,7 +60,7 @@ encoding. One disadvantage of this codec is that it is currently closed source.<
 
 <P>Unpack it, and run <CODE>./install.sh</CODE> as root.</P>
 
-<P>Note: Do NOT forget adding <CODE>/usr/local/lib</CODE> to your
+<P><B>Note:</B> Do <B>not</B> forget adding <CODE>/usr/local/lib</CODE> to your
 <CODE>/etc/ld.so.conf</CODE> and running <CODE>ldconfig</CODE>!</P>
 
 <P><B>MPlayer</B> autodetects DivX4/DivX5 if it is properly installed, just
@@ -85,18 +85,18 @@ bandwidth on the bus. For packed YUV modes (YUY2, UYVY) use the <CODE>-vc divx4<
 method. For RGB modes the speed is the same, differing at best
 according to your current color depth.</P>
 
-<P>NOTE: If your -vo driver supports direct rendering, then <CODE>-vc divx4</CODE> may be
+<P><B>Note:</B> If your <CODE>-vo</CODE> driver supports direct rendering, then
-faster, or even the fastest solution.</P>
+  <CODE>-vc divx4</CODE> may be faster or even the fastest solution.</P>
 
 
 <P><B><A NAME=2.2.1.2>2.2.1.2. FFmpeg DivX/libavcodec</A></B></P>
 
 <P>Beginning with version 0.4.2,
 <A HREF="http://ffmpeg.sourceforge.net">FFmpeg</A> contains an
-<B>open source</B> DivX codec, which is compatible with the traditional DivX.
+<B>open source</B> DivX codec, which is compatible with traditional DivX.
 <B>MPlayer</B> supports this codec, making it possible to <B>watch
-DivX/DivX4/DivX5/MP41/MP42 movies on non-x86 platforms</B>. Furthermore it offers higher
+DivX/DivX4/DivX5/MP41/MP42 movies on non-x86 platforms</B>. Furthermore it
-decoding speed than the Win32 codecs or the original
+offers higher decoding speed than the Win32 codecs or the original
 DivX4 library!</P>
 
 <P>It also contains a lot of nice codecs, such as RealVideo 1.0, WMV7,
@@ -117,7 +117,7 @@ libavcodec from the FFmpeg CVS tree as FFmpeg 0.4.5 does <B>not</B> work with
   <LI>Compile. Configure should detect problems before compilation.</LI>
 </OL>
 
-<P><B>NOTE:</B> MPlayer from CVS does contain a libavcodec
+<P><B>Note:</B> MPlayer from CVS does contain a libavcodec
 subdirectory, but it does NOT contain the source for libavcodec!
 You must follow the steps above to obtain the source for this library.</P>
 
@@ -207,8 +207,20 @@ video output driver permits it.</P>
   <LI>RealVideo 3.0 (fourcc RV30) - decoding supported by <B>RealPlayer libraries</B></LI>
 </UL>
 
-<P>On how to install RealPlayer libraries, see the
+<P>It is recommended to download and install RealPlayer8 or RealONE, because
-  <A HREF="formats.html#2.1.1.7">RealMedia file format</A> section.</P>
+  <B>MPlayer</B> can use their libraries to decode files with RealVideo 2.0 or
+  RealVideo 3.0 video. You may also just take the RealPlayer libraries from a
+  full installation and put them in a suitable directory like
+  <CODE>/usr/lib/real</CODE> or <CODE>$LIBDIR/real</CODE>. The <B>MPlayer</B>
+  configure script should detect the RealPlayer libraries there or in the
+  standard locations of a full installation. If it does not, tell configure
+  where to look with the <CODE>--with-reallibdir</CODE> switch.</P>
+
+<P><B>Note:</B> RealPlayer libraries currently <B>only work with Linux, FreeBSD,
+  NetBSD and Cygwin on the x86 platform</B>!</P>
+
+<P><B>Note2:</B> We cannot distribute the RealPlayer libraries, the license does
+  not allow this. You have to get them yourself.</P>
 
 
 <P><B><A NAME=2.2.1.9>2.2.1.9.  XViD</A></B></P>
@@ -253,16 +265,16 @@ video output driver permits it.</P>
 <P><B><A NAME=2.2.1.10>2.2.1.10.  Sorenson</A></B></P>
 
 <P><B>Sorenson</B> is a video codec developed by Apple. We are currently
-  able to decode the first version of it (SVQ1), with a native decoder.</P>
+  able to decode the first version (SVQ1) with a native decoder.</P>
 
 <P><B>Advantages:</B></P>
   <UL>
-    <LI>old, slow Macintosh machines were able to decode it</LI>
+    <LI>Fast, even old Macintosh machines were able to decode it.</LI>
   </UL>
 
 <P><B>Disadvantages:</B></P>
   <UL>
-    <LI>SVQ3 is still not reverse-engineered</LI>
+    <LI>SVQ3 is still not reverse engineered.</LI>
   </UL>
 
 <P><B>Installation:</B> it's compiled and usable per default.</P>
@@ -408,7 +420,7 @@ If not, you are out of luck. Try guessing (e.g. search for TrueMotion).
 field. Write down the 16 byte CLSID, this is the GUID we need.
 </UL>
 
-<P>NOTE: If searching fails, try enabling all the checkboxes. You may have
+<P><B>Note:</B> If searching fails, try enabling all the checkboxes. You may have
 false hits, but you may get lucky...</P>
 
 <P>Now that you have all the necessary information (fourcc, GUID, codec file,

DOCS/formats.html

@@ -42,7 +42,7 @@ and <A HREF="encoding.html">MEncoder</A> can create these files.</P>
 MPEG1 video, and MP2 (MPEG-1 layer 2) or rarely MP1 audio.</LI>
 <LI>DAT: This is the very same format as MPG with a different extension. It is used
 on <B>Video CD</B>s. Due to the way VCDs are created and Linux is designed,
-the DAT files cannot be played nor copied from VCDs as regular files. You have
+DAT files cannot be played nor copied from VCDs as regular files. You have
 to use the <CODE>-vcd</CODE> option to play the Video CD.</LI>
 <LI>VOB: This is the MPEG file format on <B>DVD</B>s. It is the same as MPG, plus the
 capability to contain subtitles or non-MPEG (AC3) audio. It contains encoded MPEG2
@@ -51,8 +51,8 @@ video and usually AC3 audio, but DTS, MP2 and uncompressed LPCM are allowed, too
 </UL>
 
 <P>Series of frames form independent groups in MPEG files. This means that you
-can cut/join an MPEG file with standard file tools (like dd, cut), and it
+can cut/join an MPEG file with standard file tools (like <CODE>dd</CODE>,
-remains completely functional.</P>
+<CODE>cut</CODE>), and it remains completely functional.</P>
 
 <P>One important feature of MPGs is that they have a field to describe
 the aspect ratio of the video stream within. For example SVCDs have
@@ -63,22 +63,22 @@ rescaled during encoding or played with the <CODE>-aspect</CODE> option.</P>
 
 <P><B><A NAME=2.1.1.2>2.1.1.2. AVI files</A></B></P>
 
-<P>Designed by Micro$oft, <B>AVI (Audio Video Interleaved)</B> is a
+<P>Designed by Microsoft, <B>AVI (Audio Video Interleaved)</B> is a
 widespread multipurpose format currently used mostly for DivX and DivX4
 video. It has many known drawbacks and shortcomings (for example in streaming).
-It supports one video stream and 0 to 99 audio streams and can be as big as
+It supports one video stream and 0 to 99 audio streams. File size is limited to
-2GB. There exists an extension allowing bigger files called <B>OpenDMS</B>.
+2GB, but there exists an extension allowing bigger files called <B>OpenDMS</B>.
-M$ currently strongly discourages its use and encourages ASF/WMV. Not that
+Microsoft currently strongly discourages its use and encourages ASF/WMV. Not that
 anybody cares.<BR>
 
 <P>There is a hack that allows AVI files to contain an Ogg Vorbis audio
   stream, but makes them incompatible with standard AVI. <B>MPlayer</B>
   supports playing these files. Seeking is also implemented but severely
   hampered by badly encoded files with confusing headers. Unfortunately the
-  only encoder currently capable of creating these files, nandub, has this
+  only encoder currently capable of creating these files, NanDub, has this
   problem.</P>
 
-<P><B>NOTE:</B> DV cameras create raw DV streams that DV grabbing utilities
+<P><B>Note:</B> DV cameras create raw DV streams that DV grabbing utilities
 convert to two different types of AVI files. The AVI will then contain either
 separate audio and video streams that <B>MPlayer</B> can play or the raw DV
 stream for which support is under development.</P>
@@ -99,8 +99,8 @@ stream for which support is under development.</P>
 <UL>
   <LI><B>bps-based</B>: It is based on the bitrate/samplerate of the video/audio stream. This
     method is used by most players, including <A HREF="http://avifile.sourceforge.net">avifile</A>
-    and windows media player.
+    and Windows Media Player.
-    Files with broken headers, and files created with VBR audio but not
+    Files with broken headers, and files created with VBR audio but not with a
     VBR-compliant encoder will result in A/V desync with this method (mostly at
     seeking).</LI>
   <LI><B>interleaving-based</B>: It does not use the bitrate value of the header, instead
@@ -111,16 +111,16 @@ stream for which support is under development.</P>
 <P>Any audio and video codec is allowed, but note that VBR audio is not well
 supported by most players. The file format makes it possible to use VBR
 audio, but most players expect CBR audio, thus they fail with VBR. VBR is
-uncommon and Microsoft's AVI specs only describe CBR audio. I also noticed that
+uncommon and the Microsoft AVI specs only describe CBR audio. Most AVI
-most AVI encoders/multiplexers create bad files when using VBR audio. There are only 
+encoders/multiplexers create bad files when using VBR audio. There are only 
-two exceptions (known to me): NaNDub and <A HREF="encoding.html">MEncoder</A>.</P>
+two known exceptions: NanDub and <A HREF="encoding.html">MEncoder</A>.</P>
 
 
 <P><B><A NAME=2.1.1.3>2.1.1.3. ASF/WMV files</A></B></P>
 
 <P>ASF (active streaming format) comes from Microsoft. They developed two
-variants of ASF, v1.0 and v2.0. v1.0 is used by their media tools (windows
+variants of ASF, v1.0 and v2.0. v1.0 is used by their media tools (Windows
-media player and windows media encoder) and is very secret. v2.0 is published
+Media Player and Windows Media Encoder) and is very secret. v2.0 is published
 and patented :). Of course they differ, there is no compatibility at all (it is
 just another legal game). <B>MPlayer</B> supports only v1.0, as nobody has ever seen
 v2.0 files :). Note that ASF files nowadays come with the extension .WMA or
@@ -129,16 +129,16 @@ v2.0 files :). Note that ASF files nowadays come with the extension .WMA or
 
 <P><B><A NAME=2.1.1.4>2.1.1.4. QuickTime/MOV files</A></B></P>
 
-<P>These formats were designed by Apple. They usually have a .QT or .MOV extension. Note
+<P>These formats were designed by Apple and can contain any codec, CBR or VBR.
-that since the MPEG4 group chose QuickTime as the recommended file format
+They usually have a .QT or .MOV extension. Ever since the MPEG4 group chose
-for MPEG4, their MOV files come with a .MPG or .MP4 extension (Interestingly
+QuickTime as the recommended file format for MPEG4, their MOV files come with a
-the video and audio streams in these files are real MPG and AAC files. With the
+.MPG or .MP4 extension (Interestingly the video and audio streams in these
-<CODE>-dumpvideo</CODE> and <CODE>-dumpaudio</CODE> options you can even extract them!).</P>
+files are real MPG and AAC files. You can even extract them with the
+<CODE>-dumpvideo</CODE> and <CODE>-dumpaudio</CODE> options.).</P>
 
-<P><B>Codecs</B>: Any codec is allowed, both CBR and VBR. Note: most new QuickTime files use
+<P><B>Note:</B> Most new QuickTime files use <B>Sorenson</B> video and QDesign
-<B>Sorenson</B> video and QDesign Music audio. See our
+  Music audio. See our <A HREF="codecs.html#2.2.1.10">Sorenson</A> codec
-<A HREF="codecs.html#2.2.1.10">Sorenson</A> codec section. QDesign Music
+  section. QDesign Music audio currently cannot be played.</P>
-audio currently can't be played.</P>
 
 
 <P><B><A NAME=2.1.1.5>2.1.1.5. VIVO files</A></B></P>
@@ -173,21 +173,6 @@ will be messy for a short time after seeking.</P>
   <A HREF="codecs.html#2.2.1.8">RealVideo</A>
   and <A HREF="codecs.html#2.2.2.5">RealAudio</A> codecs.</P>
 
-<P>It's recommended to download and install RealPlayer8 or RealONE, because
-  <B>MPlayer</B> can use their libraries to decode files with RealVideo 2.0 or
-  RealVideo 3.0 video!</P>
-
-<P>The <B>MPlayer</B> configure script should detect the RealPlayer libraries
-  in all standard locations. If it does not, tell configure where to look with
-  the <CODE>--with-reallibdir</CODE> switch.</P>
-
-<P>It is also possible to just take the RealPlayer libraries from somewhere and
-  put them in a suitable directory like <CODE>/usr/lib/real</CODE> or
-  <CODE>$LIBDIR/real</CODE>.</P>
-
-<P>NOTE: RealPlayer libraries currently <B>only work with Linux, FreeBSD,
-  NetBSD and Cygwin on the x86 platform</B>!</P>
-
 
 <P><B><A NAME=2.1.1.8>2.1.1.8. NuppelVideo files</A></B></P>
 
@@ -195,15 +180,15 @@ will be messy for a short time after seeking.</P>
 is a TV grabber tool (AFAIK:). <B>MPlayer</B> can read its .NUV  
 files (only NuppelVideo 5.0). Those files can contain uncompressed YV12,
 YV12+RTJpeg compressed, YV12 RTJpeg+lzo compressed, and YV12+lzo compressed
-frames. <B>MPlayer</B> decodes (and also <B>encodes</B> them with MEncoder to
+frames. <B>MPlayer</B> decodes them all (and also <B>encodes</B> them with
-DivX/etc!) them all. Seeking works.</P>
+<B>MEncoder</B> to DivX/etc!). Seeking works.</P>
 
 
 <P><B><A NAME=2.1.1.9>2.1.1.9. yuv4mpeg files</A></B></P>
 
 <P><A HREF="http://mjpeg.sourceforge.net">yuv4mpeg / yuv4mpeg2</A> is
 a file format used by the <A HREF="http://mjpeg.sf.net">mjpegtools programs</A>.
-You can grab, produce, filter or encode video in this format using these.
+You can grab, produce, filter or encode video in this format using these tools.
 The file format is really a sequence of uncompressed YUV 4:2:0 images.
 </P>
 
@@ -221,8 +206,9 @@ The file format is really a sequence of uncompressed YUV 4:2:0 images.
 
 <P><B><A NAME=2.1.1.12>2.1.1.12. OGG files</A></B></P>
 
-<P>This is a new fileformat from Xiphophorus, developed to contain Vorbis
+<P>This is a new file format from <A HREF="http://www.xiph.org">Xiphophorus</A>.
-  audio. You'll need <CODE>libogg</CODE> and <CODE>libvorbis</CODE> installed
+  It can contain any video or audio codec, CBR or VBR. You will need to
+  have <CODE>libogg</CODE> and <CODE>libvorbis</CODE> installed
   before compiling <B>MPlayer</B> to be able to play it.</P>