aboutsummaryrefslogtreecommitdiff
path: root/docs/markdown
diff options
context:
space:
mode:
Diffstat (limited to 'docs/markdown')
-rw-r--r--docs/markdown/Rewriter.md5
-rw-r--r--docs/markdown/snippets/rewrite_allow_double_slash_project_id.md7
2 files changed, 12 insertions, 0 deletions
diff --git a/docs/markdown/Rewriter.md b/docs/markdown/Rewriter.md
index 6414480..20b741f 100644
--- a/docs/markdown/Rewriter.md
+++ b/docs/markdown/Rewriter.md
@@ -97,6 +97,11 @@ Currently, only the following function types are supported:
For more information see the help output of the rewrite kwargs command.
+Note msys bash may expand `/` to a path. Passing `//` will be converted to
+`/` by msys bash but in order to keep usage shell-agnostic, the rewrite command
+also allows `//` as the function ID such that it will work in both msys bash
+and other shells.
+
### Setting the project default options
For setting and deleting default options, use the following command:
diff --git a/docs/markdown/snippets/rewrite_allow_double_slash_project_id.md b/docs/markdown/snippets/rewrite_allow_double_slash_project_id.md
new file mode 100644
index 0000000..9448ce6
--- /dev/null
+++ b/docs/markdown/snippets/rewrite_allow_double_slash_project_id.md
@@ -0,0 +1,7 @@
+## `//` is now allowed as a function id for `meson rewrite`.
+
+msys bash may expand `/` to a path, breaking
+`meson rewrite kwargs set project / ...`. Passing `//` will be converted to
+`/` by msys bash but in order to keep usage shell-agnostic, also allow `//`
+as the id such that `meson rewrite kwargs set project // ...` will work in
+both msys bash and other shells.