From 2cefe8fd41c5025fd4c1f17d63c7b36bc58d6e36 Mon Sep 17 00:00:00 2001
From: Gerion Entrup <32870336+gerion0@users.noreply.github.com>
Date: Sat, 4 Apr 2020 12:36:03 +0200
Subject: [PATCH] docs: add LLVM tool section to dependencies [skip ci]

---
 docs/markdown/Dependencies.md | 11 +++++++++++
 1 file changed, 11 insertions(+)

diff --git a/docs/markdown/Dependencies.md b/docs/markdown/Dependencies.md
index 05c97e537..17c999114 100644
--- a/docs/markdown/Dependencies.md
+++ b/docs/markdown/Dependencies.md
@@ -395,6 +395,17 @@ llvm_dep = dependency(
 )
 ```
 
+### Using LLVM tools
+When using LLVM as library but also needing its tools, it is often beneficial to use the same version.
+This can partially be achieved with the `version` argument of `find_program()`.
+However, distributions tend to package different LLVM versions in rather different ways.
+Therefore, it is often better to use the llvm dependency directly to retrieve the tools:
+
+```meson
+llvm_dep = dependency('llvm', version : ['>= 8', '< 9'])
+llvm_link = find_program(llvm_dep.get_variable(configtool: 'bindir') / 'llvm-link')
+```
+
 ## MPI
 
 *(added 0.42.0)*