Update of /cvsroot/quantlibaddin/QuantLibAddin/Docs/pages
In directory sc8-pr-cvs7.sourceforge.net:/tmp/cvs-serv2010/pages
Modified Files:
Tag: R000313f0-branch
build.tutorial.docs faq.docs
Log Message:
update docs for post-release issues
Index: build.tutorial.docs
===================================================================
RCS file: /cvsroot/quantlibaddin/QuantLibAddin/Docs/pages/build.tutorial.docs,v
retrieving revision 1.1.2.3
retrieving revision 1.1.2.4
diff -C2 -d -r1.1.2.3 -r1.1.2.4
*** build.tutorial.docs 11 Aug 2006 00:12:51 -0000 1.1.2.3
--- build.tutorial.docs 29 Aug 2006 08:29:42 -0000 1.1.2.4
***************
*** 24,29 ****
/*! \page build_tutorial Build Tutorial
This document explains how to build QuantLibXL and its prerequisites from
! source code. Each step is documented in detail:
\ref sec_build_vc8 \n
--- 24,41 ----
/*! \page build_tutorial Build Tutorial
+ <center><small>last updated 29 August 2006</small></center>
+
This document explains how to build QuantLibXL and its prerequisites from
! source code.
!
! If you want a binary installation of the precompiled addin, please go instead
! to the <a href="http://www.quantlibxl.org">QuantLibXL</a> web site.
!
! Before proceeding with the build please consult section \ref faq_issues of
! document \ref faq.
!
! Piter Dias has written a
! <a href="http://sourceforge.net/mailarchive/forum.php?thread_id=30355157&forum_id=4299">DOS batch file</a>
! which automates all of the steps described in this document.
\ref sec_build_vc8 \n
***************
*** 76,80 ****
\li run the command:
\verbatim
! C:\Projects\boost_1_33_1>bjam "-sTOOLS=vc-8_0" install
\endverbatim
This command will create the Boost include directory <tt>C:\\Boost\\include\\boost-1_33_1</tt> and the Boost library directory <tt>C:\\Boost\\lib</tt>. Relax: it takes a long while.
--- 88,93 ----
\li run the command:
\verbatim
! C:\Projects\boost_1_33_1>bjam "-sTOOLS=vc-8_0"
! "--with-regex" install
\endverbatim
This command will create the Boost include directory <tt>C:\\Boost\\include\\boost-1_33_1</tt> and the Boost library directory <tt>C:\\Boost\\lib</tt>. Relax: it takes a long while.
***************
*** 90,98 ****
You are now ready to build QuantLib. You need to compile the following projects:
! - <a href="http://quantlib.org/">QuantLib</a> - the core C++ analytics library
! - log4cxx - a logging framework, used by ObjectHandler
! - <a href="http://www.objecthandler.org">ObjectHandler</a> - an object repository
! - <a href="http://www.quantlibaddin.org">QuantLibAddin</a> - Addins for QuantLib functionality
! - <a href="http://www.quantlibxl.org">QuantLibXL</a> - the Excel implementation of QuantLibAddin
These projects are available with four different runtime libraries
--- 103,111 ----
You are now ready to build QuantLib. You need to compile the following projects:
! - <a href="http://quantlib.org/">QuantLib 0.3.13</a> - the core C++ analytics library
! - <b>log4cxx 0.9.7a</b> - a logging framework, used by ObjectHandler
! - <a href="http://www.objecthandler.org">ObjectHandler 0.1.4</a> - an object repository
! - <a href="http://www.quantlibaddin.org">QuantLibAddin 0.3.13</a> - Addins for QuantLib functionality
! - <a href="http://www.quantlibxl.org">QuantLibXL 0.3.13</a> - the Excel implementation of QuantLibAddin
These projects are available with four different runtime libraries
***************
*** 193,197 ****
1>STL : Dinkumware standard library version 405
1>Boost : 1.33.1
! 1>Testing Barone-Adesi and Whaley approximation for American options...
[...]
1>Testing old-style Monte Carlo multi-factor pricers...
--- 206,211 ----
1>STL : Dinkumware standard library version 405
1>Boost : 1.33.1
! 1>Testing Barone-Adesi and Whaley approximation for American
! options...
[...]
1>Testing old-style Monte Carlo multi-factor pricers...
***************
*** 202,206 ****
1> moreThan200 test cases out of moreThan200 passed
1>Build log was saved at
! 1>"file://c:\Projects\QuantLib\test-suite\build\vc80\Release\BuildLog.htm"
1>testsuite - 0 error(s), 0 warning(s)
\endverbatim
--- 216,221 ----
1> moreThan200 test cases out of moreThan200 passed
1>Build log was saved at
! 1>"file://c:\Projects\QuantLib\test-suite\build\vc80\Release\
! BuildLog.htm"
1>testsuite - 0 error(s), 0 warning(s)
\endverbatim
***************
*** 252,256 ****
\section sec_build_quantlibaddin Install and Build QuantLibAddin
! Download <tt>QuantLibAddin-0.3.13.exe</tt> and <tt>QuantLibXL-0.3.13.exe</tt> from the
<a href="http://sourceforge.net/project/showfiles.php?group_id=12740">QuantLib downloads page</a>
and install them to your hard drive. As explained above in section \ref sec_build_directories,
--- 267,271 ----
\section sec_build_quantlibaddin Install and Build QuantLibAddin
! Download <tt>QuantLibAddin-0.3.13.exe</tt> and <tt>QuantLibXL-src-0.3.13.exe</tt> from the
<a href="http://sourceforge.net/project/showfiles.php?group_id=12740">QuantLib downloads page</a>
and install them to your hard drive. As explained above in section \ref sec_build_directories,
Index: faq.docs
===================================================================
RCS file: /cvsroot/quantlibaddin/QuantLibAddin/Docs/pages/faq.docs,v
retrieving revision 1.2.2.1
retrieving revision 1.2.2.2
diff -C2 -d -r1.2.2.1 -r1.2.2.2
*** faq.docs 7 Aug 2006 11:00:36 -0000 1.2.2.1
--- faq.docs 29 Aug 2006 08:29:42 -0000 1.2.2.2
***************
*** 30,33 ****
--- 30,36 ----
<a href="http://quantlib.org/developerFAQ.shtml">QuantLib developer FAQ</a>.
+ \ref faq_issues\n
+ - \ref faq_buildtime\n
+
\ref faq_usage\n
- \ref faq_loaded\n
***************
*** 46,49 ****
--- 49,69 ----
- \ref faq_excel
+ \section faq_issues Issues With QuantLibAddin 0.3.13 Release
+
+ \section faq_buildtime QuantLibXL Build is Very Slow
+
+ There are some issues with the configuration of QuantLibXL - e.g. inclusion of
+ unnecessary header files - which cause the build to run very slowly. Depending on
+ available CPU and memory the build may take several hours to complete, or may hang
+ altogether. This will be fixed under 0.3.14, for 0.3.13 all of the following
+ workarounds have been found to be effective:
+
+ \li use faster hardware
+ \li use VC7 instead of VC8
+ \li compile for Debug instead of Release
+ \li if compiling the Release configuration, disable optimization - in the QuantLibXL
+ project, under "Properties / Configuration Properties / C/C++ / Optimization" set
+ Optimization to Disabled.
+
\section faq_usage Usage
|