1CMP0005
2-------
3
4Preprocessor definition values are now escaped automatically.
5
6This policy determines whether or not CMake should generate escaped
7preprocessor definition values added via add_definitions.  CMake
8versions 2.4 and below assumed that only trivial values would be given
9for macros in add_definitions calls.  It did not attempt to escape
10non-trivial values such as string literals in generated build rules.
11CMake versions 2.6 and above support escaping of most values, but
12cannot assume the user has not added escapes already in an attempt to
13work around limitations in earlier versions.
14
15The ``OLD`` behavior for this policy is to place definition values given
16to add_definitions directly in the generated build rules without
17attempting to escape anything.  The ``NEW`` behavior for this policy is to
18generate correct escapes for all native build tools automatically.
19See documentation of the ``COMPILE_DEFINITIONS`` target property for
20limitations of the escaping implementation.
21
22This policy was introduced in CMake version 2.6.0.  CMake version
23|release| warns when the policy is not set and uses ``OLD`` behavior.  Use
24the :command:`cmake_policy` command to set it to ``OLD`` or ``NEW`` explicitly.
25
26.. include:: DEPRECATED.txt
27