1IMPLICIT_DEPENDS_INCLUDE_TRANSFORM
2----------------------------------
3
4Specify ``#include`` line transforms for dependencies in a directory.
5
6This property specifies rules to transform macro-like ``#include`` lines
7during implicit dependency scanning of C and C++ source files.  The
8list of rules must be semicolon-separated with each entry of the form
9``A_MACRO(%)=value-with-%`` (the ``%`` must be literal).  During dependency
10scanning occurrences of ``A_MACRO(...)`` on ``#include`` lines will be
11replaced by the value given with the macro argument substituted for
12``%``.  For example, the entry
13
14::
15
16  MYDIR(%)=<mydir/%>
17
18will convert lines of the form
19
20::
21
22  #include MYDIR(myheader.h)
23
24to
25
26::
27
28  #include <mydir/myheader.h>
29
30allowing the dependency to be followed.
31
32This property applies to sources in all targets within a directory.
33The property value is initialized in each directory by its value in
34the directory's parent.
35