Commit 6d8cabe8 authored by Brian Heim's avatar Brian Heim Committed by Brad King
Browse files

Help: Clarify INCLUDE_DIRECTORIES directory property behavior

Ordering w.r.t. target creation is important for this property.

Fixes: #17754
parent 7b9d8ce1
...@@ -11,11 +11,17 @@ target property, which is used by the generators to set the include ...@@ -11,11 +11,17 @@ target property, which is used by the generators to set the include
directories for the compiler. directories for the compiler.
In addition to accepting values from that command, values may be set In addition to accepting values from that command, values may be set
directly on any directory using the :command:`set_property` command. A directly on any directory using the :command:`set_property` command, and can be
directory gets its initial value from its parent directory if it has one. set on the current directory using the :command:`set_directory_properties`
The initial value of the :prop_tgt:`INCLUDE_DIRECTORIES` target property command. A directory gets its initial value from its parent directory if it has
one. The initial value of the :prop_tgt:`INCLUDE_DIRECTORIES` target property
comes from the value of this property. Both directory and target property comes from the value of this property. Both directory and target property
values are adjusted by calls to the :command:`include_directories` command. values are adjusted by calls to the :command:`include_directories` command.
Calls to :command:`set_property` or :command:`set_directory_properties`,
however, will update the directory property value without updating target
property values. Therefore direct property updates must be made before
calls to :command:`add_executable` or :command:`add_library` for targets
they are meant to affect.
The target property values are used by the generators to set the The target property values are used by the generators to set the
include paths for the compiler. include paths for the compiler.
......
Markdown is supported
0% or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment