From cddb698aedf6ad3398ab9b98e13da46868ceb61d Mon Sep 17 00:00:00 2001
From: jzmaddock <john@johnmaddock.co.uk>
Date: Fri, 27 Feb 2015 13:25:06 +0000
Subject: [PATCH] Update for Oracle 12.4 compiler

---
 .../detail/build-from-source-head.rst         | 70 ++++++++++---------
 1 file changed, 36 insertions(+), 34 deletions(-)

diff --git a/getting_started/detail/build-from-source-head.rst b/getting_started/detail/build-from-source-head.rst
index e00e07e..4fdeb8d 100644
--- a/getting_started/detail/build-from-source-head.rst
+++ b/getting_started/detail/build-from-source-head.rst
@@ -36,40 +36,42 @@ __ http://www.boost.org/build/doc/html/bbv2/reference/tools.html
 
 .. _building b2: ../../doc/html/bbv2/installation.html
 
-+-----------+--------------------+-----------------------------+
-|Toolset    |Vendor              |Notes                        |
-|Name       |                    |                             |
-+===========+====================+=============================+
-|``acc``    |Hewlett Packard     |Only very recent versions are|
-|           |                    |known to work well with Boost|
-+-----------+--------------------+-----------------------------+
-|``borland``|Borland             |                             |
-+-----------+--------------------+-----------------------------+
-|``como``   |Comeau Computing    |Using this toolset may       |
-|           |                    |require configuring__ another|
-|           |                    |toolset to act as its backend|
-+-----------+--------------------+-----------------------------+
-|``darwin`` |Apple Computer      |Apple's version of the GCC   |
-|           |                    |toolchain with support for   |
-|           |                    |Darwin and MacOS X features  |
-|           |                    |such as frameworks.          |
-+-----------+--------------------+-----------------------------+
-|``gcc``    |The Gnu Project     |Includes support for Cygwin  |
-|           |                    |and MinGW compilers.         |
-+-----------+--------------------+-----------------------------+
-|``hp_cxx`` |Hewlett Packard     |Targeted at the Tru64        |
-|           |                    |operating system.            |
-+-----------+--------------------+-----------------------------+
-|``intel``  |Intel               |                             |
-+-----------+--------------------+-----------------------------+
-|``msvc``   |Microsoft           |                             |
-+-----------+--------------------+-----------------------------+
-|``sun``    |Sun                 |Only very recent versions are|
-|           |                    |known to work well with      |
-|           |                    |Boost.                       |
-+-----------+--------------------+-----------------------------+
-|``vacpp``  |IBM                 |The VisualAge C++ compiler.  |
-+-----------+--------------------+-----------------------------+
++-----------+--------------------+------------------------------------------------------------+
+|Toolset    |Vendor              |Notes                                                       |
+|Name       |                    |                                                            |
++===========+====================+============================================================+
+|``acc``    |Hewlett Packard     |Only very recent versions are known to work well with Boost |
++-----------+--------------------+------------------------------------------------------------+
+|``borland``|Borland             |                                                            |
++-----------+--------------------+------------------------------------------------------------+
+|``como``   |Comeau Computing    |Using this toolset may require configuring__ another        |
+|           |                    |toolset to act as its backend.                              |
++-----------+--------------------+------------------------------------------------------------+
+|``darwin`` |Apple Computer      |Apple's version of the GCC toolchain with support for       |
+|           |                    |Darwin and MacOS X features such as frameworks.             |
++-----------+--------------------+------------------------------------------------------------+
+|``gcc``    |The Gnu Project     |Includes support for Cygwin and MinGW compilers.            |
++-----------+--------------------+------------------------------------------------------------+
+|``hp_cxx`` |Hewlett Packard     |Targeted at the Tru64 operating system.                     |
++-----------+--------------------+------------------------------------------------------------+
+|``intel``  |Intel               |                                                            |
++-----------+--------------------+------------------------------------------------------------+
+|``msvc``   |Microsoft           |                                                            |
++-----------+--------------------+------------------------------------------------------------+
+|``sun``    |Oracle              |Only very recent versions are known to work well with       |
+|           |                    |Boost.  Note that the Oracle/Sun compiler has a large number|
+|           |                    |of options which effect binary compatibility: it is vital   |
+|           |                    |that the libraries are built with the same options that your|
+|           |                    |appliction will use. In particular be aware that the default|
+|           |                    |standard library may not work well with Boost, *unless you  |
+|           |                    |are building for C++11*. The particular compiler options you|
+|           |                    |need can be injected with the b2 command line options       |
+|           |                    |``cxxflags=``and ``linkflags=``.  For example to build with |
+|           |                    |the Apache standard library in C++03 mode use               |
+|           |                    |``b2 cxxflags=-library=stdcxx4 linkflags=-library=stdcxx4``.|
++-----------+--------------------+------------------------------------------------------------+
+|``vacpp``  |IBM                 |The VisualAge C++ compiler.                                 |
++-----------+--------------------+------------------------------------------------------------+
 
 __ Boost.Build_