mirror of
https://github.com/Kitware/CMake.git
synced 2026-01-05 21:31:08 -06:00
ad3c2c0b03
Every policy's documentation has a paragraph on what version of CMake introduced it, how to set the policy, and whether CMake warns if the policy is not set. The wording of this paragraph has diverged across policies over time. Factor the paragraph out into a standard advice document included by every policy.
30 lines
1.2 KiB
ReStructuredText
30 lines
1.2 KiB
ReStructuredText
CMP0063
|
|
-------
|
|
|
|
.. versionadded:: 3.3
|
|
|
|
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.
|
|
|
|
.. |INTRODUCED_IN_CMAKE_VERSION| replace:: 3.3
|
|
.. |WARNS_OR_DOES_NOT_WARN| replace:: warns
|
|
.. include:: STANDARD_ADVICE.txt
|
|
|
|
.. include:: DEPRECATED.txt
|