]>
Commit | Line | Data |
---|---|---|
f67539c2 TL |
1 | # Boost.Build Configuration Examples |
2 | ||
3 | Examples of `user-config.jam` for convenience of contributors and | |
4 | users who wish to run complete build of Boost.GIL tests and examples. | |
5 | ||
6 | ## Usage | |
7 | ||
8 | Copy any of the provided user configuration files to `%HOME%\user-config.jam` | |
9 | on Windows or `$HOME/user-config.jam` on Linux. | |
10 | ||
11 | Refer to [Boost.Build User Manual](https://boostorg.github.io/build/) | |
12 | for more details about use of configuration files. | |
13 | ||
14 | ## Examples | |
15 | ||
16 | ### `user-config-windows-vcpkg.jam` | |
17 | ||
18 | For Windows, provides minimal configuration to consume GIL dependencies | |
19 | installed using [vcpkg](https://github.com/Microsoft/vcpkg) in `C:\vcpkg`: | |
20 | ||
21 | ```console | |
22 | C:\vcpkg --triplet x86-windows install libjpeg-turbo libpng tiff | |
23 | C:\vcpkg --triplet x64-windows install libjpeg-turbo libpng tiff | |
24 | ``` | |
25 | ||
26 | The configuration recognises the two [vcpkg triplets](https://github.com/microsoft/vcpkg/blob/master/docs/users/triplets.md) | |
27 | corresponding to Boost.Build `address-model` variants, `32` and `64`. | |
28 | ||
29 | ||
30 | ```console | |
31 | C:\boost-root> b2.exe toolset=msvc-14.2 address-model=64 libs/gil/test/extension/io//simple | |
32 | Performing configuration checks | |
33 | ... | |
34 | - libjpeg : yes | |
35 | - zlib : yes | |
36 | - libpng : yes | |
37 | - libtiff : yes | |
38 | ``` | |
39 | ||
40 | Similarly, use `address-model=32` to request 32-bit build target. |