From d80372c45e0e1efcb5ed34ac820586dca8f6aa56 Mon Sep 17 00:00:00 2001 From: Aaron Smith Date: Thu, 8 Feb 2018 05:11:17 +0000 Subject: [PATCH] [docs] Update docs for cmake options LLDB_TEST_C_COMPILER and LLDB_TEST_CXX_COMPILER Summary: LLDB_TEST_COMPILER is not a valid option for CMake for LLDB. There are instead two properties LLDB_TEST_C_COMPILER and LLDB_TEST_CXX_COMPILER. Update the documents accordingly to reflect the correct information. Reviewers: zturner, lldb-commits Subscribers: llvm-commits Differential Revision: https://reviews.llvm.org/D43061 llvm-svn: 324564 --- lldb/www/build.html | 8 ++++---- lldb/www/test.html | 4 ++-- 2 files changed, 6 insertions(+), 6 deletions(-) diff --git a/lldb/www/build.html b/lldb/www/build.html index c5d050c4d4e1..2965bb2ed2a0 100755 --- a/lldb/www/build.html +++ b/lldb/www/build.html @@ -116,14 +116,14 @@ the PYTHONHOME environment variable if it is specified).
  • - LLDB_TEST_COMPILER: The test suite needs to be able to find a copy of clang.exe that it can use to compile - inferior programs. Note that MSVC is not supported here, it must be a path to a clang executable. - Note that using a release clang.exe is strongly recommended here, as it will make the test suite run much faster. + LLDB_TEST_C_COMPILER or LLDB_TEST_CXX_COMPILER: The test suite needs to be able to find a copy of clang.exe + that it can use to compile inferior programs. Note that MSVC is not supported here, it must be a path to a + clang executable. Note that using a release clang.exe is strongly recommended here, as it will make the test suite run much faster. This can be a path to any recent clang.exe, including one you built yourself.
  • Sample command line:
    - cmake -G Ninja -DLLDB_TEST_DEBUG_TEST_CRASHES=1 -DPYTHON_HOME=C:\Python35 -DLLDB_TEST_COMPILER=d:\src\llvmbuild\ninja_release\bin\clang.exe ..\..\llvm + cmake -G Ninja -DLLDB_TEST_DEBUG_TEST_CRASHES=1 -DPYTHON_HOME=C:\Python35 -DLLDB_TEST_C_COMPILER=d:\src\llvmbuild\ninja_release\bin\clang.exe ..\..\llvm

    Working with both Ninja and MSVC

    Compiling with ninja is both faster and simpler than compiling with MSVC, but chances are you still want diff --git a/lldb/www/test.html b/lldb/www/test.html index 8208f1f223b8..3d814c6ca293 100644 --- a/lldb/www/test.html +++ b/lldb/www/test.html @@ -39,8 +39,8 @@ The easiest way to run the LLDB test suite is to use the check-lldb build target. By default, the check-lldb target builds the test programs with the same compiler that was used to build LLDB. To build the tests with a different - compiler, you can set the LLDB_TEST_COMPILER CMake variable. It is possible to - customize the architecture of the test binaries and compiler used by appending -A + compiler, you can set the LLDB_TEST_C_COMPILER or the LLDB_TEST_CXX_COMPILER CMake variables. + It is possible to customize the architecture of the test binaries and compiler used by appending -A and -C options respectively to the CMake variable LLDB_TEST_USER_ARGS. For example, to test LLDB against 32-bit binaries built with a custom version of clang, do: