summaryrefslogtreecommitdiff
path: root/docs/yaml/objects
diff options
context:
space:
mode:
authorJussi Pakkanen <jpakkane@gmail.com>2022-10-23 17:24:46 +0300
committerGitHub <noreply@github.com>2022-10-23 17:24:46 +0300
commit4c2b64188d574af79f4e949078a352e39710ed68 (patch)
tree0f5f30bd067e829b696f72df4be731bf1896817c /docs/yaml/objects
parent064165485ce00aac64afd98120fd725032e559fd (diff)
parentebbaeec51b5c5c8177fe6583a2a5bd6b7f929684 (diff)
downloadmeson-4c2b64188d574af79f4e949078a352e39710ed68.tar.gz
Merge pull request #10916 from xclaesse/preprocess
Add cc.preprocess() method
Diffstat (limited to 'docs/yaml/objects')
-rw-r--r--docs/yaml/objects/compiler.yaml22
1 files changed, 22 insertions, 0 deletions
diff --git a/docs/yaml/objects/compiler.yaml b/docs/yaml/objects/compiler.yaml
index cf341119d..e10e8fe2b 100644
--- a/docs/yaml/objects/compiler.yaml
+++ b/docs/yaml/objects/compiler.yaml
@@ -586,3 +586,25 @@ methods:
gcc or msvc, but use the same argument syntax as one of those two compilers
such as clang or icc, especially when they use different syntax on different
operating systems.
+
+- name: preprocess
+ returns: list[custom_idx]
+ since: 0.64.0
+ description: |
+ Preprocess a list of source files but do not compile them. The preprocessor
+ will receive the same arguments (include directories, defines, etc) as with
+ normal compilation. That includes for example args added with
+ `add_project_arguments()`, or on the command line with `-Dc_args=-DFOO`.
+ varargs_inherit: _build_target_base
+ kwargs:
+ output:
+ type: str
+ description: |
+ Template for name of preprocessed files: `@PLAINNAME@` is replaced by
+ the source filename and `@BASENAME@` is replaced by the source filename
+ without its extension.
+ compile_args:
+ type: list[str]
+ description: |
+ Extra flags to pass to the preprocessor
+