From c02d694b178e794b47fda3a2f36f97ea0f7f8c4e Mon Sep 17 00:00:00 2001
From: Aleksey Kladov <aleksey.kladov@gmail.com>
Date: Tue, 13 Aug 2019 18:20:22 +0300
Subject: [PATCH] document how to use system llvm

---
 src/how-to-build-and-run.md | 12 ++++++++++++
 1 file changed, 12 insertions(+)

diff --git a/src/how-to-build-and-run.md b/src/how-to-build-and-run.md
index 8a803e66..2c4d2a97 100644
--- a/src/how-to-build-and-run.md
+++ b/src/how-to-build-and-run.md
@@ -469,6 +469,18 @@ You can also use `--keep-stage 1` when running tests. Something like this:
 - Initial test run: `./x.py test -i --stage 1 src/test/ui`
 - Subsequent test run: `./x.py test -i --stage 1 src/test/ui --keep-stage 1`
 
+### Building with system LLVM
+
+By default, LLVM is built from source, and that can take significant amount of time.
+An alternative is to use LLVM already installed on your computer.
+
+This is specified in the `target` section of `config.toml`:
+
+```toml
+[target.x86_64-unknown-linux-gnu]
+llvm-config = "/path/to/llvm/llvm-7.0.1/bin/llvm-config"
+```
+
 ### Other `x.py` commands
 
 Here are a few other useful `x.py` commands. We'll cover some of them in detail