IMPLICIT_DEPENDS_INCLUDE_TRANSFORM.rst
IMPLICIT_DEPENDS_INCLUDE_TRANSFORM
----------------------------------
Specify ``#include`` line transforms for dependencies in a target.
This property specifies rules to transform macro-like ``#include`` lines
during implicit dependency scanning of C and C++ source files. The
list of rules must be semicolon-separated with each entry of the form
``A_MACRO(%)=value-with-%`` (the ``%`` must be literal). During dependency
scanning occurrences of ``A_MACRO(...)`` on ``#include`` lines will be
replaced by the value given with the macro argument substituted for
``%``. For example, the entry
::
MYDIR(%)=<mydir/%>
will convert lines of the form
::
#include MYDIR(myheader.h)
to
::
#include <mydir/myheader.h>
allowing the dependency to be followed.
This property applies to sources in the target on which it is set.