source: general/prog/gcc3.xml@ 4697ee3

<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
   "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
  <!ENTITY % general-entities SYSTEM "../../general.ent">
  %general-entities;

  <!ENTITY gcc3-download-http "http://ftp.gnu.org/gnu/gcc/gcc-&gcc3-version;.tar.bz2">
  <!ENTITY gcc3-download-ftp "ftp://ftp.gnu.org/gnu/gcc/gcc-&gcc3-version;.tar.bz2">
  <!ENTITY gcc3-size          "23 MB">
  <!ENTITY gcc3-buildsize     "473 MB">
  <!ENTITY gcc3-time          "2.60 SBU">
]>

<sect1 id="gcc3" xreflabel="GCC-&gcc3-version;">
<sect1info>
<othername>$LastChangedBy: archaic $</othername>
<date>$Date: 2004-08-09 23:25:57 -0500 (Mon, 09 Aug 2004) $</date>
</sect1info>
<?dbhtml filename="gcc3.html" ?>
<title>GCC-&gcc3-version;</title>

<sect2>
<title>Introduction to <application><acronym>GCC</acronym></application>-&gcc3-version;</title>

<para>The reason for installing <acronym>GCC</acronym>-&gcc3-version; is that 
some <acronym>BLFS</acronym> packages (such as compiled Java) have not
been updated to be compilable by <acronym>GCC</acronym>-&gcc-version;.</para>

<sect3><title>Package information</title>
<itemizedlist spacing='compact'>
<listitem><para>Download (HTTP): <ulink
url="&gcc3-download-http;"/></para></listitem>
<listitem><para>Download (FTP): <ulink
url="&gcc3-download-ftp;"/></para></listitem>
<listitem><para>Download size: &gcc3-size;</para></listitem>
<listitem><para>Estimated disk space required:
&gcc3-buildsize;</para></listitem>
<listitem><para>Estimated build time:
&gcc3-time;</para></listitem></itemizedlist>
</sect3>

<sect3><title>Additional downloads</title>
<itemizedlist spacing='compact'>

<listitem><para>Required Patch: <ulink 
url="&patch-root;/gcc-&gcc3-version;-no_fixincludes-1.patch"/></para></listitem>

<listitem><para>Required Patch: <ulink
url="&patch-root;/gcc-&gcc3-version;-linkonce-1.patch"/></para></listitem>

</itemizedlist>
</sect3>

</sect2>

<sect2>
<title>Installation of <application><acronym>GCC</acronym></application></title>

<para>Apply the patches:</para>

<screen><userinput><command>patch -Np1 -i ../gcc-&gcc3-version;-no_fixincludes-1.patch &amp;&amp;
patch -Np1 -i ../gcc-&gcc3-version;-linkonce-1.patch </command></userinput></screen>

<para>The <acronym>GCC</acronym> development team recommends building in a 
separate directory.</para>

<screen><userinput><command>mkdir ../gcc-build &amp;&amp;
cd ../gcc-build</command></userinput></screen>

<para>Configure <acronym>GCC</acronym> to build the
<application>C</application> and <application>C++</application> compilers and 
enable the related <application>C++</application> options.</para>

<screen><userinput><command>../gcc-&gcc3-version;/configure \
    --prefix=/opt/gcc-&gcc3-version; \
    --enable-shared --enable-languages=c,c++ \
    --enable-threads=posix</command></userinput></screen>

<para>Compile and install <acronym>GCC</acronym>:</para>

<screen><userinput><command>make bootstrap &amp;&amp;
make install</command></userinput></screen>

<para>Move the <application>C++</application> libraries to the standard lib 
directory to avoid having to add <userinput>/opt/gcc-&gcc3-version;/lib
</userinput> to <filename>/etc/ld.so.conf</filename>.</para>

<screen><userinput><command>mv /opt/gcc-&gcc3-version;/lib/libstdc++.so.5* /usr/lib</command></userinput></screen>

</sect2>

<sect2>
<title>Configuring <application><acronym>GCC</acronym></application></title>

<sect3><title>Configuration Information</title>

<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="../../lib-config.xml"/>  

<para>If you only need the GCC-&gcc3-version; libraries, you may delete
<filename>/opt/gcc-&gcc3-version;</filename>.</para>

<para>Whenever you need to use GCC-&gcc3-version; instead of your system
installed compiler, add
<filename class="directory">/opt/gcc-&gcc3-version;/bin</filename> to the 
front of your <envar>PATH</envar> or (preferably) set the <envar>CC</envar>
environment variable before compiling the concerned package.</para>

</sect3>

</sect2>

<sect2>
<title>Contents</title>

<para>The GCC-&gcc3-version; package contains the
<command>gcc</command>-&gcc3-version; <application>C</application> and
<application>C++</application> compilers and GCC-&gcc3-version;
<filename>libstdc++.so</filename> that is required by some commercial and
pre-compiled packages.</para>

</sect2>

</sect1>