aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorL. E. Segovia <amy@amyspark.me>2023-08-30 22:38:22 -0300
committerEli Schwartz <eschwartz93@gmail.com>2023-09-15 07:31:37 -0400
commitca60f71b2e70c0af09b5f77f3a03fd42b7109c0a (patch)
treeb63f4d4fe168602630ea4d4a0314b0710b8a0796
parent878d950887f5d02b830ea190262af5d0491ae0f8 (diff)
downloadmeson-ca60f71b2e70c0af09b5f77f3a03fd42b7109c0a.zip
meson-ca60f71b2e70c0af09b5f77f3a03fd42b7109c0a.tar.gz
meson-ca60f71b2e70c0af09b5f77f3a03fd42b7109c0a.tar.bz2
reference tables: Document how to set compiler paths with spaces in environment variables
See #11128
-rw-r--r--docs/markdown/Reference-tables.md20
1 files changed, 20 insertions, 0 deletions
diff --git a/docs/markdown/Reference-tables.md b/docs/markdown/Reference-tables.md
index 4a869ad..a21b40b 100644
--- a/docs/markdown/Reference-tables.md
+++ b/docs/markdown/Reference-tables.md
@@ -377,6 +377,26 @@ machine](#Environment-variables-per-machine) section for details.
*The old environment variables are still supported, but are deprecated
and will be removed in a future version of Meson.*
+*changed in 1.3.0* Paths with spaces were split unconditionally to extract
+components such as the [path to Ccache](Feature-autodetection.md#ccache),
+intrinsic compiler flags like `-m32` or `--target`, etc. This broke passing
+a hardcoded compiler path to CMake subprojects. To work around this, paths
+must be wrapped with double quotes:
+
+```bash
+export CC='"C:/Program Files/Microsoft Visual Studio/2022/Community/VC/Tools/MSVC/14.34.31933/bin/Hostx64/x64/cl.exe"'
+```
+
+You can also set the values through [machine files](Machine-files.md#binaries).
+
+*New in 1.3.0* Paths that point to an existing executable no longer need
+wrapping:
+
+```bash
+export CC='C:/Program Files/Microsoft Visual Studio/2022/Community/VC/Tools/MSVC/14.34.31933/bin/Hostx64/x64/cl.exe'
+```
+
+
## Environment variables per machine
Since *0.54.0*, Following Autotool and other legacy build systems,