mirror of
https://github.com/Kitware/CMake.git
synced 2026-04-22 22:31:18 -05:00
Brad King
91dc94c4ac
The `CMAKE_MSVC_DEBUG_INFORMATION_FORMAT` variable docs mention that it
initializes the `MSVC_DEBUG_INFORMATION_FORMAT` target property, but the
property's docs was missing any mention of the variable.
Follow the pattern from commit c1b07ca9da (Help: MSVC_RUNTIME_LIBRARY is
initialized from associated variable, 2022-08-13, v3.25.0-rc1~317^2).
Fixes: #25216
36 lines
1.2 KiB
ReStructuredText
36 lines
1.2 KiB
ReStructuredText
MSVC_DEBUG_INFORMATION_FORMAT
|
|
-----------------------------
|
|
|
|
.. versionadded:: 3.25
|
|
|
|
Select debug information format when targeting the MSVC ABI.
|
|
|
|
The allowed values are:
|
|
|
|
.. include:: MSVC_DEBUG_INFORMATION_FORMAT-VALUES.txt
|
|
|
|
Use :manual:`generator expressions <cmake-generator-expressions(7)>` to
|
|
support per-configuration specification. For example, the code:
|
|
|
|
.. code-block:: cmake
|
|
|
|
add_executable(foo foo.c)
|
|
set_property(TARGET foo PROPERTY
|
|
MSVC_DEBUG_INFORMATION_FORMAT "$<$<CONFIG:Debug,RelWithDebInfo>:ProgramDatabase>")
|
|
|
|
selects for the target ``foo`` the program database debug information format
|
|
for the Debug configuration.
|
|
|
|
This property is initialized from the value of the
|
|
:variable:`CMAKE_MSVC_DEBUG_INFORMATION_FORMAT` variable, if it is set.
|
|
If this property is not set, CMake selects a debug information format using
|
|
the default value ``$<$<CONFIG:Debug,RelWithDebInfo>:ProgramDatabase>``, if
|
|
supported by the compiler, and otherwise
|
|
``$<$<CONFIG:Debug,RelWithDebInfo>:Embedded>``.
|
|
|
|
.. note::
|
|
|
|
This property has effect only when policy :policy:`CMP0141` is set to ``NEW``
|
|
prior to the first :command:`project` or :command:`enable_language` command
|
|
that enables a language using a compiler targeting the MSVC ABI.
|