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.
28 lines
1.2 KiB
ReStructuredText
28 lines
1.2 KiB
ReStructuredText
CMP0020
|
|
-------
|
|
|
|
Automatically link Qt executables to ``qtmain`` target on Windows.
|
|
|
|
CMake 2.8.10 and lower required users of Qt to always specify a link
|
|
dependency to the ``qtmain.lib`` static library manually on Windows.
|
|
CMake 2.8.11 gained the ability to evaluate generator expressions
|
|
while determining the link dependencies from ``IMPORTED`` targets. This
|
|
allows CMake itself to automatically link executables which link to Qt
|
|
to the ``qtmain.lib`` library when using ``IMPORTED`` Qt targets. For
|
|
applications already linking to ``qtmain.lib``, this should have little
|
|
impact. For applications which supply their own alternative WinMain
|
|
implementation and for applications which use the QAxServer library,
|
|
this automatic linking will need to be disabled as per the
|
|
documentation.
|
|
|
|
The ``OLD`` behavior for this policy is not to link executables to
|
|
``qtmain.lib`` automatically when they link to the QtCore ``IMPORTED`` target.
|
|
The ``NEW`` behavior for this policy is to link executables to ``qtmain.lib``
|
|
automatically when they link to QtCore ``IMPORTED`` target.
|
|
|
|
.. |INTRODUCED_IN_CMAKE_VERSION| replace:: 2.8.11
|
|
.. |WARNS_OR_DOES_NOT_WARN| replace:: warns
|
|
.. include:: STANDARD_ADVICE.txt
|
|
|
|
.. include:: DEPRECATED.txt
|