• Home
Name Date Size #Lines LOC

..--

README.mdD12-May-20241.3 KiB4128

user-config-windows-vcpkg.jamD12-May-20241.2 KiB5445

README.md

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