|
|
@@ -0,0 +1,50 @@
|
|
|
+CMP0136
|
|
|
+-------
|
|
|
+
|
|
|
+.. versionadded:: 3.24
|
|
|
+
|
|
|
+Watcom runtime library flags are selected by an abstraction.
|
|
|
+
|
|
|
+Compilers targeting the Watcom ABI have flags to select the Watcom runtime
|
|
|
+library.
|
|
|
+
|
|
|
+In CMake 3.23 and below, Watcom runtime library selection flags are added to
|
|
|
+the default :variable:`CMAKE_<LANG>_FLAGS_<CONFIG>` cache entries by CMake
|
|
|
+automatically. This allows users to edit their cache entries to adjust the
|
|
|
+flags. However, the presence of such default flags is problematic for
|
|
|
+projects that want to choose a different runtime library programmatically.
|
|
|
+In particular, it requires string editing of the
|
|
|
+:variable:`CMAKE_<LANG>_FLAGS_<CONFIG>` variables with knowledge of the
|
|
|
+CMake builtin defaults so they can be replaced.
|
|
|
+
|
|
|
+CMake 3.24 and above prefer to leave the Watcom runtime library selection flags
|
|
|
+out of the default :variable:`CMAKE_<LANG>_FLAGS_<CONFIG>` values and instead
|
|
|
+offer a first-class abstraction. The :variable:`CMAKE_WATCOM_RUNTIME_LIBRARY`
|
|
|
+variable and :prop_tgt:`WATCOM_RUNTIME_LIBRARY` target property may be set to
|
|
|
+select the Watcom runtime library. If they are not set then CMake uses the
|
|
|
+default value ``MultiThreadedDLL`` on Windows and ``SingleThreaded`` on other
|
|
|
+platforms, which is equivalent to the original flags.
|
|
|
+
|
|
|
+This policy provides compatibility with projects that have not been updated
|
|
|
+to be aware of the abstraction. The policy setting takes effect as of the
|
|
|
+first :command:`project` or :command:`enable_language` command that enables
|
|
|
+a language whose compiler targets the Watcom ABI.
|
|
|
+
|
|
|
+.. note::
|
|
|
+
|
|
|
+ Once the policy has taken effect at the top of a project, that choice
|
|
|
+ must be used throughout the tree. In projects that have nested projects
|
|
|
+ in subdirectories, be sure to convert everything together.
|
|
|
+
|
|
|
+The ``OLD`` behavior for this policy is to place Watcom runtime library
|
|
|
+flags in the default :variable:`CMAKE_<LANG>_FLAGS_<CONFIG>` cache
|
|
|
+entries and ignore the :variable:`CMAKE_WATCOM_RUNTIME_LIBRARY` abstraction.
|
|
|
+The ``NEW`` behavior for this policy is to *not* place Watcom runtime
|
|
|
+library flags in the default cache entries and use the abstraction instead.
|
|
|
+
|
|
|
+This policy was introduced in CMake version 3.24. Use the
|
|
|
+:command:`cmake_policy` command to set it to ``OLD`` or ``NEW`` explicitly.
|
|
|
+Unlike many policies, CMake version |release| does *not* warn
|
|
|
+when this policy is not set and simply uses ``OLD`` behavior.
|
|
|
+
|
|
|
+.. include:: DEPRECATED.txt
|