Help/prop_tgt/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.