1CMP0020
2-------
3
4Automatically link Qt executables to ``qtmain`` target on Windows.
5
6CMake 2.8.10 and lower required users of Qt to always specify a link
7dependency to the ``qtmain.lib`` static library manually on Windows.
8CMake 2.8.11 gained the ability to evaluate generator expressions
9while determining the link dependencies from ``IMPORTED`` targets.  This
10allows CMake itself to automatically link executables which link to Qt
11to the ``qtmain.lib`` library when using ``IMPORTED`` Qt targets.  For
12applications already linking to ``qtmain.lib``, this should have little
13impact.  For applications which supply their own alternative WinMain
14implementation and for applications which use the QAxServer library,
15this automatic linking will need to be disabled as per the
16documentation.
17
18The ``OLD`` behavior for this policy is not to link executables to
19``qtmain.lib`` automatically when they link to the QtCore ``IMPORTED`` target.
20The ``NEW`` behavior for this policy is to link executables to ``qtmain.lib``
21automatically when they link to QtCore ``IMPORTED`` target.
22
23This policy was introduced in CMake version 2.8.11.  CMake version
24|release| warns when the policy is not set and uses ``OLD`` behavior.  Use
25the :command:`cmake_policy` command to set it to ``OLD`` or ``NEW`` explicitly.
26
27.. include:: DEPRECATED.txt
28