File: CMP0203.rst

package info (click to toggle)
cmake 4.2.1-1
  • links: PTS, VCS
  • area: main
  • in suites: experimental
  • size: 152,348 kB
  • sloc: ansic: 403,894; cpp: 303,807; sh: 4,097; python: 3,582; yacc: 3,106; lex: 1,279; f90: 538; asm: 471; lisp: 375; cs: 270; java: 266; fortran: 239; objc: 215; perl: 213; xml: 198; makefile: 108; javascript: 83; pascal: 63; tcl: 55; php: 25; ruby: 22
file content (28 lines) | stat: -rw-r--r-- 1,186 bytes parent folder | download | duplicates (2)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
CMP0203
-------

.. versionadded:: 4.2

``_WINDLL`` is defined for shared libraries targeting the MSVC ABI.

In CMake 4.1 and below, :ref:`Visual Studio Generators` compile sources in
shared libraries with ``_WINDLL`` defined due to behavior of Visual Studio
itself.  The preprocessor definition is not modeled by CMake and is therefore
not added by other generators, such as :generator:`Ninja`.

CMake 4.2 and above, when targeting the MSVC ABI, prefer to compile sources
in shared libraries with ``_WINDLL`` defined by all generators.
This policy provides compatibility with projects that have not been updated
to be aware of the definition.  Its setting is recorded by each target as
it is created, and affects compilation of sources in that target.

The ``OLD`` behavior for this policy does not model the ``_WINDLL``
preprocessor definition in CMake itself.  The ``NEW`` behavior for this
policy adds the ``_WINDLL`` preprocessor definition to sources in shared
libraries when targeting the MSVC ABI.

.. |INTRODUCED_IN_CMAKE_VERSION| replace:: 4.2
.. |WARNS_OR_DOES_NOT_WARN| replace:: does *not* warn
.. include:: include/STANDARD_ADVICE.rst

.. include:: include/DEPRECATED.rst