mirror of
https://github.com/reactos/CMake.git
synced 2024-12-18 17:16:58 +00:00
482a3bf3f0
The most likely documentation page a project author will read in response to a policy warning is the page for the policy itself. Add to every policy documentation page a note explicitly stating that the OLD behavior is deprecated. Also mention this in the cmake_policy() command documentation that explains how to set a policy to OLD. Suggested-by: Fraser Hutchison <fraser.hutchison@gmail.com>
29 lines
1.3 KiB
ReStructuredText
29 lines
1.3 KiB
ReStructuredText
CMP0063
|
|
-------
|
|
|
|
Honor visibility properties for all target types.
|
|
|
|
The :prop_tgt:`<LANG>_VISIBILITY_PRESET` and
|
|
:prop_tgt:`VISIBILITY_INLINES_HIDDEN` target properties affect visibility
|
|
of symbols during dynamic linking. When first introduced these properties
|
|
affected compilation of sources only in shared libraries, module libraries,
|
|
and executables with the :prop_tgt:`ENABLE_EXPORTS` property set. This
|
|
was sufficient for the basic use cases of shared libraries and executables
|
|
with plugins. However, some sources may be compiled as part of static
|
|
libraries or object libraries and then linked into a shared library later.
|
|
CMake 3.3 and above prefer to honor these properties for sources compiled
|
|
in all target types. This policy preserves compatibility for projects
|
|
expecting the properties to work only for some target types.
|
|
|
|
The ``OLD`` behavior for this policy is to ignore the visibility properties
|
|
for static libraries, object libraries, and executables without exports.
|
|
The ``NEW`` behavior for this policy is to honor the visibility properties
|
|
for all target types.
|
|
|
|
This policy was introduced in CMake version 3.3. CMake version
|
|
|release| warns when the policy is not set and uses ``OLD`` behavior. Use
|
|
the :command:`cmake_policy()` command to set it to ``OLD`` or ``NEW``
|
|
explicitly.
|
|
|
|
.. include:: DEPRECATED.txt
|