1[/ 2 / Copyright (c) 2003 Boost.Test contributors 3 / 4 / Distributed under the Boost Software License, Version 1.0. (See accompanying 5 / file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt) 6 /] 7 8 9[section:build_utf Building the __UTF__] 10In case you would like to use the [link boost_test.usage_variants.shared_lib shared library variant] or the [link boost_test.usage_variants.static_lib static library variant] of the __UTF__, the library needs to be built. 11Building the __UTF__ is in fact quite easy. 12 13In the sequel, we define 14 15* $`boost_path` refers to the location where the boost archive was deflated 16* $`boost_installation_prefix` refers to the location where you want to install the __UTF__ 17 18[/ not true 19 [note By default, the static and dynamic variant will be built for your operating system] 20] 21 22More documentation about *Boost's build system* can be found [@http://www.boost.org/more/getting_started/index.html here]. 23 24[h3 Windows] 25 26You need to have a compilation toolchain. /Visual Studio Express/ is such one, freely available from the 27Microsoft website. Once installed, open a /Visual Studio Command Line tools/ prompt and build the Boost build program `b2` 28(see the link above). You will then be able to compile the __UTF__ with different variants. 29 30[h4 Static variant] 31For building 32bits libraries, open a console window and enter the following commands: 32``` 33> cd ``$``boost_path 34> bootstrap.bat 35> b2 address-model=32 architecture=x86 --with-test link=static \ 36> --prefix=``$``boost_installation_prefix install 37``` 38 39For building 64bits libraries, the commands become: 40``` 41> cd ``$``boost_path 42> bootstrap.bat 43> b2 address-model=64 architecture=x86 --with-test link=static \ 44> --prefix=``$``boost_installation_prefix install 45``` 46 47[h4 Shared library variant] 48In order to build the shared library variant, the directive `link=static` should be replaced by `link=shared` on the above command lines. 49For instance, for 64bits builds, the commands become: 50 51``` 52> cd ``$``boost_path 53> bootstrap.bat 54> b2 address-model=64 architecture=x86 --with-test link=shared --prefix=``$``boost_installation_prefix install 55``` 56 57[h3 Linux/OSX] 58For Unix/Linux/OSX operating system, the build of the __UTF__ is very similar to the one on Windows: 59``` 60> cd ``$``boost_path 61> ./bootstrap.sh 62> ./b2 --with-test --prefix=``$``boost_installation_prefix install 63``` 64 65[endsect] [/build_utf] 66