summaryrefslogtreecommitdiffstats
path: root/Help
diff options
context:
space:
mode:
authorBrad King <brad.king@kitware.com>2024-05-10 13:50:02 (GMT)
committerBrad King <brad.king@kitware.com>2024-05-10 13:50:33 (GMT)
commitd6bda72981974888049fb2441e96f578d2d3deae (patch)
treee1d15e5589850c6b668b60f8de2d106448146685 /Help
parent2e5b40f581c9c58a92d6f166e6ca28e8a3cc3563 (diff)
downloadCMake-d6bda72981974888049fb2441e96f578d2d3deae.zip
CMake-d6bda72981974888049fb2441e96f578d2d3deae.tar.gz
CMake-d6bda72981974888049fb2441e96f578d2d3deae.tar.bz2
Help: Document TARGET_PROPERTY genex behavior on unset property
Also add an explicit test for the case. Fixes: #25968
Diffstat (limited to 'Help')
-rw-r--r--Help/manual/cmake-generator-expressions.7.rst10
1 files changed, 6 insertions, 4 deletions
diff --git a/Help/manual/cmake-generator-expressions.7.rst b/Help/manual/cmake-generator-expressions.7.rst
index f8c722b..49d94ef 100644
--- a/Help/manual/cmake-generator-expressions.7.rst
+++ b/Help/manual/cmake-generator-expressions.7.rst
@@ -1751,7 +1751,8 @@ These expressions look up the values of
.. genex:: $<TARGET_PROPERTY:tgt,prop>
- Value of the property ``prop`` on the target ``tgt``.
+ Value of the property ``prop`` on the target ``tgt``, or empty if
+ the property is not set.
Note that ``tgt`` is not added as a dependency of the target this
expression is evaluated on.
@@ -1767,9 +1768,10 @@ These expressions look up the values of
:target: TARGET_PROPERTY:prop
Value of the property ``prop`` on the target for which the expression
- is being evaluated. Note that for generator expressions in
- :ref:`Target Usage Requirements` this is the consuming target rather
- than the target specifying the requirement.
+ is being evaluated, or empty if the property is not set.
+ Note that for generator expressions in :ref:`Target Usage Requirements`
+ this is the consuming target rather than the target specifying the
+ requirement.
The expressions have special evaluation rules for some properties: