[QuantLibAddin-cvs] QuantLibAddin/Docs/pages calc.docs, 1.1.2.1, 1.1.2.2

SourceForge Headquarters 1320 Columbia Street Suite 310 San Diego, CA 92101 +1 (858) 422-6466

Update of /cvsroot/quantlibaddin/QuantLibAddin/Docs/pages
In directory sc8-pr-cvs7.sourceforge.net:/tmp/cvs-serv12112/Docs/pages

Modified Files:
      Tag: R000313f0-branch
	calc.docs 
Log Message:
document gcc 3.4.1 patch

Index: calc.docs
===================================================================
RCS file: /cvsroot/quantlibaddin/QuantLibAddin/Docs/pages/calc.docs,v
retrieving revision 1.1.2.1
retrieving revision 1.1.2.2
diff -C2 -d -r1.1.2.1 -r1.1.2.2
*** calc.docs	4 Aug 2006 21:06:37 -0000	1.1.2.1
--- calc.docs	5 Aug 2006 11:19:57 -0000	1.1.2.2
***************
*** 109,113 ****
  For standard binary distributions, the current version of OOo, 2.0, is compiled by the vendor with gcc 3.4.1.  A complete listing of the OOo compiler versions by environment is maintained <a href="http://wiki.services.openoffice.org/wiki/Compiler_versions_used_by_port_maintainers_and_release_engineers">here</a>.

! In all likelihood gcc 3.4.1 is not shipped with your distribution and you'll need to install it alongside your existing version of gcc.  You're advised to recompile and install gcc 3.4.1 from source as binary installations of gcc 3.4.1 (e.g. rpms) are unlikely to be recognized by your distribution.  The gcc 3.4.1 source tarball can be acquired from one of the <a href="http://gcc.gnu.org/mirrors.html">gcc mirror sites.</a>

  Please see the following document describing the procedure for maintaining multiple versions of gcc concurrently:  <a href="http://www.tellurian.com.au/document.php?document=multiplegcc.html&titleprefix=White+Papers">Installing and Using Multiple Versions of GCC</a>
--- 109,115 ----
  For standard binary distributions, the current version of OOo, 2.0, is compiled by the vendor with gcc 3.4.1.  A complete listing of the OOo compiler versions by environment is maintained <a href="http://wiki.services.openoffice.org/wiki/Compiler_versions_used_by_port_maintainers_and_release_engineers">here</a>.

! \subsection calc_compiler_build Building gcc 3.4.1
! 
! In all likelihood gcc 3.4.1 is not shipped with your distribution and you'll need to install it alongside your existing version of gcc.  You're advised to recompile and install gcc 3.4.1 from source (installing a required patch as noted below) because binary installations of gcc 3.4.1 (e.g. rpms) are unlikely to be recognized by your distribution.  The gcc 3.4.1 source tarball can be acquired from one of the <a href="http://gcc.gnu.org/mirrors.html">gcc mirror sites.</a>

  Please see the following document describing the procedure for maintaining multiple versions of gcc concurrently:  <a href="http://www.tellurian.com.au/document.php?document=multiplegcc.html&titleprefix=White+Papers">Installing and Using Multiple Versions of GCC</a>
***************
*** 115,119 ****
  Please see also the standard gcc installation notes: <a href="http://gcc.gnu.org/install">Installing GCC</a>

! NB: GCC's default configuration includes support for numerous platforms (such as Ada) which 1) are not required for %QuantLibAddin and 2) may not build correctly, depending on your environment.  You can run configure with the \c --enable-languages option to restrict the build to only those platforms you require e.g.

  \verbatim
--- 117,133 ----
  Please see also the standard gcc installation notes: <a href="http://gcc.gnu.org/install">Installing GCC</a>

! \subsection calc_compiler_patch Patching gcc 3.4.1
! 
! The version of gcc 3.4.1 available from the mirrors noted above contains a bug (the "linkonce" bug) which must be patched in order to compile the addin.  As you build gcc - after uncompressing the gcc source, but before building it - patch the source as follows:
! \li Get the patch from <a href="http://www.linuxfromscratch.org/patches/lfs/6.0/gcc-3.4.1-linkonce-1.patch">this page</a>.
! \li Copy and paste the contents of the above page into a file.  Give the file an appropriate name e.g. 'gcc.linkonce.patch' and save it to the directory containing the root directory of your gcc source tree.
! \li Ensure that the paths in the patch file correspond to those in your directory tree.  For example the patch file identifies the root directory of the source tree as gcc-3.4.1.orig, if on your system the root directory is gcc-3.4.1 then you need to rename your root directory or edit the patch file.
! \li In the same directory as the patch file, invoke the command<br><tt>patch -p0 <gcc.linkonce.patch</tt>
! \li Some of the patches may fail, in which case the patch utility creates <tt>.rej</tt> files, you need to manually apply the patches.  
! \li You're now ready to proceed with building gcc.
! 
! \subsection calc_compiler_config Configuring gcc 3.4.1
! 
! gcc's default configuration includes support for numerous platforms (such as Ada) which 1) are not required for %QuantLibAddin and 2) may not build correctly, depending on your environment.  You can run configure with the \c --enable-languages option to restrict the build to only those platforms you require e.g.

  \verbatim