summaryrefslogtreecommitdiffstats
path: root/Help/command/set_property.rst
diff options
context:
space:
mode:
Diffstat (limited to 'Help/command/set_property.rst')
-rw-r--r--Help/command/set_property.rst43
1 files changed, 43 insertions, 0 deletions
diff --git a/Help/command/set_property.rst b/Help/command/set_property.rst
new file mode 100644
index 0000000..8cb963e
--- /dev/null
+++ b/Help/command/set_property.rst
@@ -0,0 +1,43 @@
+set_property
+------------
+
+Set a named property in a given scope.
+
+::
+
+ set_property(<GLOBAL |
+ DIRECTORY [dir] |
+ TARGET [target1 [target2 ...]] |
+ SOURCE [src1 [src2 ...]] |
+ TEST [test1 [test2 ...]] |
+ CACHE [entry1 [entry2 ...]]>
+ [APPEND] [APPEND_STRING]
+ PROPERTY <name> [value1 [value2 ...]])
+
+Set one property on zero or more objects of a scope. The first
+argument determines the scope in which the property is set. It must
+be one of the following:
+
+GLOBAL scope is unique and does not accept a name.
+
+DIRECTORY scope defaults to the current directory but another
+directory (already processed by CMake) may be named by full or
+relative path.
+
+TARGET scope may name zero or more existing targets.
+
+SOURCE scope may name zero or more source files. Note that source
+file properties are visible only to targets added in the same
+directory (CMakeLists.txt).
+
+TEST scope may name zero or more existing tests.
+
+CACHE scope must name zero or more cache existing entries.
+
+The required PROPERTY option is immediately followed by the name of
+the property to set. Remaining arguments are used to compose the
+property value in the form of a semicolon-separated list. If the
+APPEND option is given the list is appended to any existing property
+value.If the APPEND_STRING option is given the string is append to any
+existing property value as string, i.e. it results in a longer string
+and not a list of strings.