From 4d0233540f15c686c199d8f464fc7499a094645e Mon Sep 17 00:00:00 2001
From: TheQwertiest <qwertiest@mail.ru>
Date: Thu, 21 May 2020 17:05:04 +0300
Subject: Added ability to pass arguments to backend in `meson compile`

---
 docs/markdown/snippets/add_compile_backend_arg.md | 26 +++++++++++++++++++++++
 1 file changed, 26 insertions(+)
 create mode 100644 docs/markdown/snippets/add_compile_backend_arg.md

(limited to 'docs/markdown/snippets')

diff --git a/docs/markdown/snippets/add_compile_backend_arg.md b/docs/markdown/snippets/add_compile_backend_arg.md
new file mode 100644
index 0000000..76e2abb
--- /dev/null
+++ b/docs/markdown/snippets/add_compile_backend_arg.md
@@ -0,0 +1,26 @@
+## Added ability to specify backend arguments in `meson compile`
+
+It's now possible to specify backend specific arguments in `meson compile`.
+
+Usage: `meson compile [--vs-args=args] [--ninja-args=args]`
+
+```
+  --ninja-args NINJA_ARGS    Arguments to pass to `ninja` (applied only on `ninja` backend).
+  --vs-args VS_ARGS          Arguments to pass to `msbuild` (applied only on `vs` backend).
+```
+
+These arguments use the following syntax:
+
+If you only pass a single string, then it is considered to have all values separated by commas. Thus invoking the following command:
+
+```
+$ meson compile --ninja-args=-n,-d,explain
+```
+
+would add `-n`, `-d` and `explain` arguments to ninja invocation.
+
+If you need to have commas or spaces in your string values, then you need to pass the value with proper shell quoting like this:
+
+```
+$ meson compile "--ninja-args=['a,b', 'c d']"
+```
-- 
cgit v1.1