[cmake] Document and suggest LLVM_ENABLE_PDB (#102887)

As suggested in #101533. @rnk added the flag in
b97ff922a9eeea6efbf12deba907848e5002cc76
This commit is contained in:
Hans 2024-08-13 11:26:06 +02:00 committed by GitHub
parent 71d2de8ecd
commit f9b15a96c6
No known key found for this signature in database
GPG Key ID: B5690EEEBB952194

View File

@ -218,6 +218,11 @@ used variables that control features of LLVM and enabled subprojects.
If you are using an IDE such as Visual Studio or Xcode, you should use
the IDE settings to set the build type.
Note: on Windows (building with MSVC or clang-cl), CMake's **RelWithDebInfo**
setting does not enable the same optimizations as **Release**. Using the
**Release** build type with :ref:`LLVM_ENABLE_PDB <llvm_enable_pdb>` set
may be a better option.
**CMAKE_INSTALL_PREFIX**:PATH
Path where LLVM will be installed when the "install" target is built.
@ -548,6 +553,12 @@ enabled sub-projects. Nearly all of these variable names begin with
Compile with `Clang Header Modules
<https://clang.llvm.org/docs/Modules.html>`_.
.. _llvm_enable_pdb:
**LLVM_ENABLE_PDB**:BOOL
For Windows builds using MSVC or clang-cl, generate PDB files when
:ref:`CMAKE_BUILD_TYPE <cmake_build_type>` is set to Release.
**LLVM_ENABLE_PEDANTIC**:BOOL
Enable pedantic mode. This disables compiler-specific extensions, if
possible. Defaults to ON.