IMPLICIT_DEPENDS_INCLUDE_TRANSFORM.rst 908 B

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