[MPlayer-dev-eng] gcc-3.x patch for docs (and some other minor things) (was: Re: [MPlayer-users] yes I did rtfm)

Dominik Mierzejewski dominik at rangers.eu.org
Thu Jun 27 14:01:06 CEST 2002 

On Thursday, 27 June 2002, Dominik Mierzejewski wrote:
> On Thursday, 27 June 2002, Sylvain Petreolle wrote:
> > please update this in doc, this would (perhaps) make
> > decrease the number of bugreports with RH compilers.
> 
> Ok, I'll prepare a patch.

Here goes.
Basically, I added info that 3.1 is better than 3.0.4. Do we recommend 3.1?
I wrote so. I also corrected some spelling/grammar mistakes and added
lame requirement (mencoder needs it to encode mp3) and added gcc-2.96/lame
bug solution.

-- 
MPlayer RPMs: http://msp-190.man.olsztyn.pl/~dominik/linux/pkgs/mplayer/
"The Universe doesn't give you any points for doing things that are easy."
        -- Sheridan to Garibaldi in Babylon 5:"The Geometry of Shadows"
Dominik 'Rathann' Mierzejewski <rathann(at)rangers.eu.org>
-------------- next part --------------
Index: documentation.html
===================================================================
RCS file: /cvsroot/mplayer/main/DOCS/documentation.html,v
retrieving revision 1.264
diff -u -r1.264 documentation.html
--- documentation.html	22 Jun 2002 10:22:48 -0000	1.264
+++ documentation.html	27 Jun 2002 11:48:17 -0000
@@ -416,25 +416,26 @@
 <UL>
   <LI><B>binutils</B> - suggested version is <B>2.11.x</B> . This program is
     responsible for generating MMX/3DNow!/etc instructions, thus very important.</LI>
-  <LI><B>gcc</B> - suggested version is from <B>2.95.3</B> to <B>2.95.4</B>.
-    <B>NEVER</B> use 2.96 or 3.x.x !!! They generate faulty code. If you decide
-    to change gcc from 2.96, then don't decide in favor of 3.0 juts because
-    it's newer! In some ways it's even worse than 2.96. So downgrade to
-    2.95.x (downgrade libstdc++ too!) or don't up/downgrade at all (but in
-    this case, be prepared for runtime problems).
+  <LI><B>gcc</B> - suggested versions are: <B>2.95.3</B>, <B>2.95.4</B> and
+    <B>3.1</B>.
+    <B>NEVER</B> use 2.96 or 3.0.x !!! They generate faulty code for MPlayer.
+    If you decide to change gcc from 2.96, then don't decide in favor of 3.0.x
+    just because it's newer! Early releases of 3.0.x were even more buggy than
+    2.96. So downgrade to 2.95.x (downgrade libstdc++ too!) or don't
+    up/downgrade at all (but in this case, be prepared for runtime problems).
     If you vote for 3.x, try to use the latest version, early releases had
     various bugs, so be sure you use at least 3.0.3 or 3.1.
     Detailed information about gcc 2.96's bugs (that are still NOT fixed, they
-    are WORKAROUNDED in <B>MPlayer</B>!) can be found
+    have been WORKED AROUND in <B>MPlayer</B>!) can be found
     <A HREF="users_against_developers.html"><B><I>here</I></B></A> and in the
     <A HREF="faq.html">FAQ</A> !</LI>
   <LI><B>XFree86</B> - suggested version is <B>always the newest (4.2.0)</B>.
-    Normally everyone wants this, as starting from XFree86 4.0.2, it contains
-    the <A HREF="video.html#2.3.1.2">XVideo</A> extension (somewhere referred
+    Normally, everyone wants this, as starting with XFree86 4.0.2, it contains
+    the <A HREF="video.html#2.3.1.2">XVideo</A> extension (somewhere referred to
     as <B>Xv</B>) which is needed to enable the hardware YUV acceleration (fast
     image display) on cards that support it. <A HREF="video.html#2.3.1.2">More
     information available.</A><BR>
-    Make sure its <B>development package</B> is installed too otherwise
+    Make sure its <B>development package</B> is installed, too, otherwise
     it won't work.<BR>
     For some videocards you don't need XFree86. See list below.</LI>
   <LI><B>make</B> - suggested version is <B>always the newest</B> (at least 3.79.x). This
@@ -446,6 +447,8 @@
     Useful for both <B>MPlayer</B> and <B>MEncoder</B> if you plan to work with jpeg files.</LI>
   <LI><B>libpng</B> - recommended and default (M)PNG decoder. Required for GUI.
     Useful for both <B>MPlayer</B> and <B>MEncoder</B>.</LI>
+  <LI><B>lame</B> - recommended, needed for encoding MP3 audio with MEncoder,
+    suggested version is <B>always the newest</B> (at least 3.90).</LI>
   <LI><B>libogg</B> - optional, needed for playing OGG file format.</LI>
   <LI><B>libvorbis</B> - optional, needed for playing OGG Vorbis audio.</LI>
 </UL>
@@ -2506,10 +2509,10 @@
   Workaround: ./configure --disable-sse etc. options</LI>
 
 <LI>"Internal buffer inconsistency" during MEncoder run:<BR>
-  Problem: known problem when lame was compiled with gcc 2.96 or 3.x, no fix
-  yet.<BR>
-  Workaround: compile lame with gcc 2.95. Be sure to remove any installed
-  lame packages, they may have been compiled with gcc 2.96 .</LI>
+  Problem: known problem when lame &lt; 3.90 was compiled with gcc 2.96 or 3.x.<BR>
+  Solution: use lame &gt;=3.90.<BR>
+  Workaround: compile lame with gcc 2.95.x and remove any already installed
+  lame packages, they may have been compiled with gcc 2.96.</LI>
 
 <LI>Messed up MP2/MP3 sound on PPC:<BR>
   Problem: known GCC miscompilation bug on PPC platforms, no fix yet.<BR>
Index: users_against_developers.html
===================================================================
RCS file: /cvsroot/mplayer/main/DOCS/users_against_developers.html,v
retrieving revision 1.21
diff -u -r1.21 users_against_developers.html
--- users_against_developers.html	12 Jun 2002 23:53:28 -0000	1.21
+++ users_against_developers.html	27 Jun 2002 11:48:17 -0000
@@ -65,17 +65,21 @@
 
 <P>If you have problems with GCC 2.96, you can get 2.96-85 packages from the
 Red Hat <A HREF="ftp://updates.redhat.com">ftp server</A>, or just go for the
-3.04 packages offered for version 7.2 and later. If you do not want to or cannot
-use the binary packages, here is how you can compile GCC 3.0.4 from source:</P>
+3.0.4 packages offered for version 7.2 and later. You can also get 3.1
+packages prepared by RH's GCC maintainer (unofficial, but working fine)
+<A HREF="ftp://people.redhat.com/jakub/gcc3/3.1-1/">here</A> and you can
+install them along the gcc-2.96 you already have. MPlayer will detect it and
+use 3.1 instead of 2.96. If you do not want to or cannot use the binary
+packages, here is how you can compile GCC 3.1 from source:</P>
 
 <UL>
   <LI>Go to the <A HREF="http://gcc.gnu.org/mirrors.html">GCC mirrors page</A>
-    page and download <CODE>gcc-core-3.0.4.tar.gz</CODE>.  This includes the
+    page and download <CODE>gcc-core-3.1.tar.gz</CODE>.  This includes the
     complete C compiler and is sufficient for <B>MPlayer</B>. If you also want
     C++, Java or some of the other advanced GCC features
-    <CODE>gcc-3.0.4.tar.gz</CODE> may better suit your needs.</LI>
+    <CODE>gcc-3.1.tar.gz</CODE> may better suit your needs.</LI>
   <LI>Extract the archive with<BR>
-    <CODE>tar -xvzf gcc-core-3.0.4.tar.gz</CODE></LI>
+    <CODE>tar -xvzf gcc-core-3.1.tar.gz</CODE></LI>
   <LI>GCC is not built inside the source directory itself like most programs,
     but needs a build directory outside the source directory.  Thus you need to
     create this directory via<BR>
@@ -83,7 +87,7 @@
   <LI>Then you can proceed to configure gcc in the build directory, but you need
     the configure from the source directory:<BR>
     <CODE>cd gcc-build<BR>
-    ../gcc-3.0.4/configure</CODE></LI>
+    ../gcc-3.1/configure</CODE></LI>
   <LI>Compile GCC by issuing this command in the build directory:<BR>
     <CODE>make bootstrap</CODE></LI>
   <LI>Now you can install GCC (as root) by typing<BR>

More information about the MPlayer-dev-eng mailing list