| 123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869 |
- set_property
- ------------
- Set a named property in a given scope.
- ::
- set_property(<GLOBAL |
- DIRECTORY [dir] |
- TARGET [target1 [target2 ...]] |
- SOURCE [src1 [src2 ...]] |
- INSTALL [file1 [file2 ...]] |
- 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).
- ``INSTALL``
- Scope may name zero or more installed file paths.
- These are made available to CPack to influence deployment.
- Both the property key and value may use generator expressions.
- Specific properties may apply to installed files and/or directories.
- Path components have to be separated by forward slashes,
- must be normalized and are case sensitive.
- To reference the installation prefix itself with a relative path use ".".
- Currently installed file properties are only defined for
- the WIX generator where the given paths are relative
- to the installation prefix.
- ``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.
- See the :manual:`cmake-properties(7)` manual for a list of properties
- in each scope.
|
