aboutsummaryrefslogtreecommitdiff
path: root/docs/markdown
diff options
context:
space:
mode:
authorNiklas Claesson <nicke.claesson@gmail.com>2017-09-06 23:54:49 +0200
committerNiklas Claesson <nicke.claesson@gmail.com>2017-10-01 18:49:27 +0200
commitbbdba876afa8adfaf3e1d1985908326443875860 (patch)
treef79a3326050c6db10b854dc64af3a50534be261b /docs/markdown
parent09ccd0eeaad402f1e7e5b18bd1ad168a9db2998b (diff)
downloadmeson-bbdba876afa8adfaf3e1d1985908326443875860.zip
meson-bbdba876afa8adfaf3e1d1985908326443875860.tar.gz
meson-bbdba876afa8adfaf3e1d1985908326443875860.tar.bz2
Boost: Improve search algorithm
The new implementation will correctly pick boost from 3 possible locations on windows and two locations on posix compatible OSs. The new search algorithm also differentiates between debug and release builds of Boost and multi or single threading builds. It was also decided to map "Meson modules" to Boost software libraries and not Boost modules since it there are a lot of options regarding linking. Some modules can even be used either as headers-only or with dynamic linking. This commit also fixes a bug that prevented header-only use on Windows. Fixes: #2274 #2239 #1803 #669
Diffstat (limited to 'docs/markdown')
-rw-r--r--docs/markdown/Dependencies.md15
-rw-r--r--docs/markdown/Release-notes-for-0.43.0/001-boost-platform-improvement.md10
2 files changed, 23 insertions, 2 deletions
diff --git a/docs/markdown/Dependencies.md b/docs/markdown/Dependencies.md
index 187c4fe..c46334c 100644
--- a/docs/markdown/Dependencies.md
+++ b/docs/markdown/Dependencies.md
@@ -50,8 +50,16 @@ pkg-config files. Meson has autodetection support for some of these.
## Boost ##
Boost is not a single dependency but rather a group of different
-libraries. To use Boost with Meson, simply list which Boost modules
-you would like to use.
+libraries. To use Boost headers-only libraries, simply add Boost as a
+dependency.
+
+```meson
+boost_dep = dependency('boost')
+exe = executable('myprog', 'file.cc', dependencies : boost_dep)
+```
+
+To link against boost with Meson, simply list which libraries you would like to
+use.
```meson
boost_dep = dependency('boost', modules : ['thread', 'utility'])
@@ -65,6 +73,9 @@ If your boost headers or libraries are in non-standard locations you
can set the BOOST_ROOT, BOOST_INCLUDEDIR, and/or BOOST_LIBRARYDIR
environment variables.
+You can set the argument `threading` to `single` to use boost libraries that
+has been compiled for single-threaded use instead.
+
## GTest and GMock ##
GTest and GMock come as sources that must be compiled as part of your
diff --git a/docs/markdown/Release-notes-for-0.43.0/001-boost-platform-improvement.md b/docs/markdown/Release-notes-for-0.43.0/001-boost-platform-improvement.md
new file mode 100644
index 0000000..2cd44ce
--- /dev/null
+++ b/docs/markdown/Release-notes-for-0.43.0/001-boost-platform-improvement.md
@@ -0,0 +1,10 @@
+## Portability improvements to Boost Dependency
+
+The Boost dependency has been improved to better detect the various ways to
+install boost on multiple platforms. At the same time the `modules` semantics
+for the dependency has been changed. Previously it was allowed to specify
+header directories as `modules` but it wasn't required. Now, modules are only
+used to specify libraries that require linking.
+
+This is a breaking change and the fix is to remove all modules that aren't
+found.