diff options
| author | Brad King <brad.king@kitware.com> | 2022-06-10 14:39:42 (GMT) |
|---|---|---|
| committer | Kitware Robot <kwrobot@kitware.com> | 2022-06-10 14:40:05 (GMT) |
| commit | d63ec8645f5b296bb6b09f47240f26cf44994429 (patch) | |
| tree | c2d19d741e502df1f4bf064b28037287085cd35d /Help/policy | |
| parent | 84da420a29155e206cef48fc7b05bf818539feb6 (diff) | |
| parent | 7d73e88d3a7490cf1047369da8292a57c0b60bce (diff) | |
| download | CMake-d63ec8645f5b296bb6b09f47240f26cf44994429.zip CMake-d63ec8645f5b296bb6b09f47240f26cf44994429.tar.gz CMake-d63ec8645f5b296bb6b09f47240f26cf44994429.tar.bz2 | |
Merge topic 'revert-msvc-compilers-default-to-ZI' into release-3.24
7d73e88d3a MSVC: Revert "Default to -ZI instead of /Zi for x86 and x64"
Acked-by: Kitware Robot <kwrobot@kitware.com>
Tested-by: buildbot <buildbot@kitware.com>
Merge-request: !7344
Diffstat (limited to 'Help/policy')
| -rw-r--r-- | Help/policy/CMP0138.rst | 32 |
1 files changed, 1 insertions, 31 deletions
diff --git a/Help/policy/CMP0138.rst b/Help/policy/CMP0138.rst index 5cf3948..c7f0e2d 100644 --- a/Help/policy/CMP0138.rst +++ b/Help/policy/CMP0138.rst @@ -3,37 +3,7 @@ CMP0138 .. versionadded:: 3.24 -MSVC compilers use ``-ZI`` instead of ``/Zi`` for x86 and x64 by default. - -When using MSVC C/C++ compilers in CMake 3.23 and below, debug information -format flag ``/Zi`` is added to :variable:`CMAKE_<LANG>_FLAGS_DEBUG` and -:variable:`CMAKE_<LANG>_FLAGS_RELWITHDEBINFO` by default. The ``/Zi`` flag -produces a separate PDB file that contains all the symbolic debugging -information for use with the debugger, however, it does not support Edit -and Continue feature in a debugging session. - -CMake 3.24 and above adds ``-ZI`` to :variable:`CMAKE_<LANG>_FLAGS_DEBUG` -and :variable:`CMAKE_<LANG>_FLAGS_RELWITHDEBINFO` instead to enable Edit -and Continue by default. - -This policy provides compatibility with projects that have not been updated -to expect the lack of warning flags. The policy setting takes effect as of -the first :command:`project` or :command:`enable_language` command that -initializes :variable:`CMAKE_<LANG>_FLAGS_DEBUG` and -:variable:`CMAKE_<LANG>_FLAGS_RELWITHDEBINFO` for a given language -``<LANG>`` using MSVC compilers. - -.. note:: - - Once the policy has taken effect at the top of a project for a given - language, that choice must be used throughout the tree for that language. - In projects that have nested projects in subdirectories, be sure to - convert everything together. - -The ``OLD`` behavior for this policy is to place ``/Zi`` in the default -:variable:`CMAKE_<LANG>_FLAGS_DEBUG` and -:variable:`CMAKE_<LANG>_FLAGS_RELWITHDEBINFO` cache entries. The ``NEW`` -behavior for this policy is to place ``-ZI`` in the default cache entries. +Placeholder for reverted policy. This policy was introduced in CMake version 3.24. Use the :command:`cmake_policy` command to set it to ``OLD`` or ``NEW`` explicitly. |