aboutsummaryrefslogtreecommitdiff
path: root/docs/markdown/snippets
diff options
context:
space:
mode:
authorXavier Claessens <xavier.claessens@collabora.com>2022-10-13 14:39:47 -0400
committerXavier Claessens <xavier.claessens@collabora.com>2022-10-23 12:21:46 +0200
commitd53486bf9c7d860141371c90d0dc1c923a350fed (patch)
tree4f6a6f497058580f3366542d96deedc61890b471 /docs/markdown/snippets
parent1d56df94097678fbdf05fa9ca04e0b90ff65cf2c (diff)
downloadmeson-d53486bf9c7d860141371c90d0dc1c923a350fed.zip
meson-d53486bf9c7d860141371c90d0dc1c923a350fed.tar.gz
meson-d53486bf9c7d860141371c90d0dc1c923a350fed.tar.bz2
Add doc and release notes for cc.preprocess()
Diffstat (limited to 'docs/markdown/snippets')
-rw-r--r--docs/markdown/snippets/preprocess.md14
1 files changed, 14 insertions, 0 deletions
diff --git a/docs/markdown/snippets/preprocess.md b/docs/markdown/snippets/preprocess.md
new file mode 100644
index 0000000..7e6dd0a
--- /dev/null
+++ b/docs/markdown/snippets/preprocess.md
@@ -0,0 +1,14 @@
+## New method to preprocess source files
+
+Compiler object has a new `preprocess()` method. It is supported by all C/C++
+compilers. It preprocess sources without compiling 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`.
+
+```meson
+cc = meson.get_compiler('c')
+pp_files = cc.preprocess('foo.c', 'bar.c', output: '@PLAINNAME@')
+exe = executable('app', pp_files)
+```