devenv: Set WINEPATH when cross compiling for Windows

2 files changed, 10 insertions, 0 deletions

diff --git a/docs/markdown/Commands.md b/docs/markdown/Commands.md
index b1371663f..762cd2f0c 100644
--- a/docs/markdown/Commands.md
+++ b/docs/markdown/Commands.md
@@ -351,4 +351,10 @@ top build directory, that file is loaded by gdb automatically. In the case of
 python scripts that needs to load other python modules, `PYTHONPATH` may need
 to be modified using `meson.add_devenv()`.
 
+Since *Since 0.63.0* when cross compiling for Windows `WINEPATH` is used instead
+of `PATH` which allows running Windows executables using wine. Note that since
+`WINEPATH` size is currently limited to 1024 characters, paths relative to the
+root of build directory are used. That means current workdir must be the root of
+build directory when running wine.
+
 {{ devenv_arguments.inc }}
diff --git a/docs/markdown/snippets/devenv_winepath.md b/docs/markdown/snippets/devenv_winepath.md
new file mode 100644
index 000000000..b9e24a0e5
--- /dev/null
+++ b/docs/markdown/snippets/devenv_winepath.md
@@ -0,0 +1,4 @@
+## Running Windows executables with Wine in `meson devenv`
+
+When cross compiling for Windows, `meson devenv` now sets `WINEPATH` pointing to
+all directories containing needed DLLs and executables.