[llvm-branch-commits] [llvm] [BOLT][Docs] Add instructions to run all tests. (PR #172847)

[Paschalis Mpeis via llvm-branch-commits]

================
@@ -59,6 +59,34 @@ Start with cloning LLVM repo:
 `llvm-bolt` will be available under `bin/`. Add this directory to your path to
 ensure the rest of the commands in this tutorial work.
 
+### Testing changes during development
+
+During development, it is recommended to run both the in-tree tests (under
+[bolt/test](./test)) and the out-of-tree tests, which use binaries hosted in an
+[external](https://github.com/rafaelauler/bolt-tests) repository.
+
+Below are sample instructions to run both test suites. You may need to define
+additional CMake variables.
+
+```bash
+git clone https://github.com/llvm/llvm-project.git
+git clone https://github.com/rafaelauler/bolt-tests
+mkdir build
+cmake -G Ninja -S llvm-project/llvm -B build \
+       -DLLVM_TARGETS_TO_BUILD='AArch64;X86' \
+       -DCMAKE_BUILD_TYPE=Release \
+       -DBUILD_SHARED_LIBS=ON \
+       -DLLVM_BUILD_TOOLS=ON \
+       -DLLVM_ENABLE_ASSERTIONS=ON \
+       -DLLVM_ENABLE_PROJECTS='clang;bolt;clang-tools-extra;lld' \
+       -DLLVM_USE_LINKER=lld \
+       -DLLVM_CCACHE_BUILD=ON \
----------------
paschalis-mpeis wrote:

Done. Created the below PR and I updated this one to reference it:
- #173066

Can you please check that it works? I've tested this new dockerfile on an Ubuntu host.
There's an unrelated x86 test (heatmaps) failing due to multiple lit threads, but I'll put a fix soon.

https://github.com/llvm/llvm-project/pull/172847