9890cfc4ec
Covers almost all blocks containing actual code, except: * Parsed-literal blocks can't be highlighted, including many command summaries and substitution-heavy docs like find_... commands. This is a Sphinx limitation. * Code with errors, like CMP0049, DEPLOYMENT_ADDITIONAL_FILES, DEPLOYMENT_REMOTE_DIRECTORY, @PACKAGE_INIT@ substitution in the tutorial, bracket arguments/comments in cmake-language.7 and cmake-developer.7. * FindQt4 module, which needs reformatting.
35 lines
962 B
ReStructuredText
35 lines
962 B
ReStructuredText
IMPLICIT_DEPENDS_INCLUDE_TRANSFORM
|
|
----------------------------------
|
|
|
|
Specify ``#include`` line transforms for dependencies in a directory.
|
|
|
|
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
|
|
|
|
.. code-block:: c
|
|
|
|
#include MYDIR(myheader.h)
|
|
|
|
to
|
|
|
|
.. code-block:: c
|
|
|
|
#include <mydir/myheader.h>
|
|
|
|
allowing the dependency to be followed.
|
|
|
|
This property applies to sources in all targets within a directory.
|
|
The property value is initialized in each directory by its value in
|
|
the directory's parent.
|