document COMMON_LANGUAGE_RUNTIME target properties

This commit is contained in:
Michael Stürmer
2018-03-22 17:16:39 +01:00
parent 4b7a82b4ed
commit 312527de47
4 changed files with 37 additions and 0 deletions
+2
View File
@@ -143,6 +143,7 @@ Properties on Targets
/prop_tgt/C_EXTENSIONS
/prop_tgt/C_STANDARD
/prop_tgt/C_STANDARD_REQUIRED
/prop_tgt/COMMON_LANGUAGE_RUNTIME
/prop_tgt/COMPATIBLE_INTERFACE_BOOL
/prop_tgt/COMPATIBLE_INTERFACE_NUMBER_MAX
/prop_tgt/COMPATIBLE_INTERFACE_NUMBER_MIN
@@ -186,6 +187,7 @@ Properties on Targets
/prop_tgt/GNUtoMS
/prop_tgt/HAS_CXX
/prop_tgt/IMPLICIT_DEPENDS_INCLUDE_TRANSFORM
/prop_tgt/IMPORTED_COMMON_LANGUAGE_RUNTIME
/prop_tgt/IMPORTED_CONFIGURATIONS
/prop_tgt/IMPORTED_GLOBAL
/prop_tgt/IMPORTED_IMPLIB_CONFIG
+19
View File
@@ -0,0 +1,19 @@
COMMON_LANGUAGE_RUNTIME
-----------------------
By setting this target property, the target is configured to build with
``C++/CLI`` support.
The Visual Studio generator defines the ``clr`` parameter depending on
the value of ``COMMON_LANGUAGE_RUNTIME``:
* property not set: native C++ (i.e. default)
* property set but empty: mixed unmanaged/managed C++
* property set to any non empty value: managed C++
Supported values: ``""``, ``"pure"``, ``"safe"``
This property is only evaluated :ref:`Visual Studio Generators` for
VS 2010 and above.
See also :prop_tgt:`IMPORTED_COMMON_LANGUAGE_RUNTIME`
@@ -0,0 +1,8 @@
IMPORTED_COMMON_LANGUAGE_RUNTIME
--------------------------------
Property to define if the target uses ``C++/CLI``.
Ignored for non-imported targets.
See also the :prop_tgt:`COMMON_LANGUAGE_RUNTIME` target property.
@@ -0,0 +1,8 @@
target property COMMON_LANGUAGE_RUNTIME
---------------------------------------
* The :prop_tgt:`COMMON_LANGUAGE_RUNTIME` target property was introduced
to configure the use of managed C++ for :ref:`Visual Studio Generators`
for VS 2010 and above.
* To support ``C++/CLI`` for imported targets, the
:prop_tgt:`IMPORTED_COMMON_LANGUAGE_RUNTIME` was added.