PageRenderTime 25ms CodeModel.GetById 19ms app.highlight 3ms RepoModel.GetById 1ms app.codeStats 1ms

/Src/Dependencies/Boost/more/getting_started/detail/build-from-source-head.rst

http://hadesmem.googlecode.com/
ReStructuredText | 122 lines | 97 code | 25 blank | 0 comment | 0 complexity | 74b3d4539d805d437638154fce95c68d MD5 | raw file
  1.. Copyright David Abrahams 2006. Distributed under the Boost
  2.. Software License, Version 1.0. (See accompanying
  3.. file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
  4
  5Install Boost.Build
  6...................
  7
  8Boost.Build_ is a text-based system for developing, testing, and
  9installing software. First, you'll need to build and
 10install it. To do this:
 11
 121. Go to the directory ``tools``\ |/|\ ``build``\ |/|\ ``v2``\ |/|.
 132. Run ``bootstrap.bat``
 143. Run ``b2 install --prefix=``\ *PREFIX* where *PREFIX* is
 15   the directory where you want Boost.Build to be installed
 164. Add *PREFIX*\ |/|\ ``bin`` to your PATH environment variable.
 17
 18.. _Boost.Build: ../../tools/build/index.html
 19.. _Boost.Build documentation: Boost.Build_
 20
 21.. _toolset:
 22.. _toolset-name:
 23
 24Identify Your Toolset
 25.....................
 26
 27First, find the toolset corresponding to your compiler in the
 28following table (an up-to-date list is always available `in the
 29Boost.Build documentation`__).
 30
 31__ http://www.boost.org/boost-build2/doc/html/bbv2/reference/tools.html
 32
 33.. Note:: If you previously chose a toolset for the purposes of
 34  `building b2`_, you should assume it won't work and instead
 35  choose newly from the table below.
 36
 37.. _building b2: ../../doc/html/bbv2/installation.html
 38
 39+-----------+--------------------+-----------------------------+
 40|Toolset    |Vendor              |Notes                        |
 41|Name       |                    |                             |
 42+===========+====================+=============================+
 43|``acc``    |Hewlett Packard     |Only very recent versions are|
 44|           |                    |known to work well with Boost|
 45+-----------+--------------------+-----------------------------+
 46|``borland``|Borland             |                             |
 47+-----------+--------------------+-----------------------------+
 48|``como``   |Comeau Computing    |Using this toolset may       |
 49|           |                    |require configuring__ another|
 50|           |                    |toolset to act as its backend|
 51+-----------+--------------------+-----------------------------+
 52|``cw``     |Metrowerks/Freescale|The CodeWarrior compiler.  We|
 53|           |                    |have not tested versions of  |
 54|           |                    |this compiler produced since |
 55|           |                    |it was sold to Freescale.    |
 56+-----------+--------------------+-----------------------------+
 57|``dmc``    |Digital Mars        |As of this Boost release, no |
 58|           |                    |version of dmc is known to   |
 59|           |                    |handle Boost well.           |
 60+-----------+--------------------+-----------------------------+
 61|``darwin`` |Apple Computer      |Apple's version of the GCC   |
 62|           |                    |toolchain with support for   |
 63|           |                    |Darwin and MacOS X features  |
 64|           |                    |such as frameworks.          |
 65+-----------+--------------------+-----------------------------+
 66|``gcc``    |The Gnu Project     |Includes support for Cygwin  |
 67|           |                    |and MinGW compilers.         |
 68+-----------+--------------------+-----------------------------+
 69|``hp_cxx`` |Hewlett Packard     |Targeted at the Tru64        |
 70|           |                    |operating system.            |
 71+-----------+--------------------+-----------------------------+
 72|``intel``  |Intel               |                             |
 73+-----------+--------------------+-----------------------------+
 74|``msvc``   |Microsoft           |                             |
 75+-----------+--------------------+-----------------------------+
 76|``qcc``    |QNX Software Systems|                             |
 77+-----------+--------------------+-----------------------------+
 78|``sun``    |Sun                 |Only very recent versions are|
 79|           |                    |known to work well with      |
 80|           |                    |Boost.                       |
 81+-----------+--------------------+-----------------------------+
 82|``vacpp``  |IBM                 |The VisualAge C++ compiler.  |
 83+-----------+--------------------+-----------------------------+
 84
 85__ Boost.Build_
 86
 87If you have multiple versions of a particular compiler installed,
 88you can append the version number to the toolset name, preceded by
 89a hyphen, e.g. ``intel-9.0`` or
 90``borland-5.4.3``. |windows-version-name-caveat|
 91
 92
 93.. _build directory:
 94.. _build-directory:
 95
 96Select a Build Directory
 97........................
 98
 99Boost.Build_ will place all intermediate files it generates while
100building into the **build directory**.  If your Boost root
101directory is writable, this step isn't strictly necessary: by
102default Boost.Build will create a ``bin.v2/`` subdirectory for that
103purpose in your current working directory.
104
105Invoke ``b2``
106...............
107
108.. |build-directory| replace:: *build-directory*
109.. |toolset-name| replace:: *toolset-name*
110
111Change your current directory to the Boost root directory and
112invoke ``b2`` as follows:
113
114.. parsed-literal::
115
116  b2 **--build-dir=**\ |build-directory|_ **toolset=**\ |toolset-name|_ |build-type-complete| stage
117
118For a complete description of these and other invocation options,
119please see the `Boost.Build documentation`__.
120
121__ http://www.boost.org/boost-build2/doc/html/bbv2/advanced/invocation.html
122