From edee1b18b20b7d994ed82196bf4214e47e003d42 Mon Sep 17 00:00:00 2001 From: Craig Scott Date: Fri, 23 Aug 2024 09:56:48 +1000 Subject: Help: Minor formatting and grammar fixes for get_property() --- Help/command/get_property.rst | 20 ++++++++++---------- 1 file changed, 10 insertions(+), 10 deletions(-) diff --git a/Help/command/get_property.rst b/Help/command/get_property.rst index a0a12bb..bd1347f 100644 --- a/Help/command/get_property.rst +++ b/Help/command/get_property.rst @@ -29,7 +29,7 @@ It must be one of the following: Scope is unique and does not accept a name. ``DIRECTORY`` - Scope defaults to the current directory but another + Scope defaults to the current directory, but another directory (already processed by CMake) may be named by the full or relative path ````. Relative paths are treated as relative to the current source directory. @@ -79,10 +79,10 @@ It must be one of the following: ``DIRECTORY `` The test property will be read from the ```` directory's - scope. CMake must already know about the directory, either by having added - it through a call to :command:`add_subdirectory` or ```` being the top - level directory. Relative paths are treated as relative to the current - source directory. ```` may reference a binary directory. + scope. CMake must already know about the directory, either by having + added it through a call to :command:`add_subdirectory` or ```` being + the top level directory. Relative paths are treated as relative to the + current source directory. ```` may reference a binary directory. ``CACHE`` Scope must name one cache entry. @@ -95,15 +95,15 @@ the property to get. If the property is not set an empty value is returned, although some properties support inheriting from a parent scope if defined to behave that way (see :command:`define_property`). -If the ``SET`` option is given the variable is set to a boolean +If the ``SET`` option is given, the variable is set to a boolean value indicating whether the property has been set. If the ``DEFINED`` -option is given the variable is set to a boolean value indicating -whether the property has been defined such as with the +option is given, the variable is set to a boolean value indicating +whether the property has been defined, such as with the :command:`define_property` command. -If ``BRIEF_DOCS`` or ``FULL_DOCS`` is given then the variable is set to a +If ``BRIEF_DOCS`` or ``FULL_DOCS`` is given, then the variable is set to a string containing documentation for the requested property. If -documentation is requested for a property that has not been defined +documentation is requested for a property that has not been defined, ``NOTFOUND`` is returned. .. note:: -- cgit v0.12 From a1fdcb9d474d83e3adbd249acd670b23a025dbeb Mon Sep 17 00:00:00 2001 From: Craig Scott Date: Fri, 23 Aug 2024 09:58:46 +1000 Subject: Help: get_property() result var is unset if property is not set Fixes: #26152 --- Help/command/get_property.rst | 7 ++++--- 1 file changed, 4 insertions(+), 3 deletions(-) diff --git a/Help/command/get_property.rst b/Help/command/get_property.rst index bd1347f..202bfd9 100644 --- a/Help/command/get_property.rst +++ b/Help/command/get_property.rst @@ -91,9 +91,10 @@ It must be one of the following: Scope is unique and does not accept a name. The required ``PROPERTY`` option is immediately followed by the name of -the property to get. If the property is not set an empty value is -returned, although some properties support inheriting from a parent scope -if defined to behave that way (see :command:`define_property`). +the property to get. If the property is not set, the named ```` +will be unset in the calling scope upon return, although some properties +support inheriting from a parent scope if defined to behave that way +(see :command:`define_property`). If the ``SET`` option is given, the variable is set to a boolean value indicating whether the property has been set. If the ``DEFINED`` -- cgit v0.12