From 09cbc53f57f63709c952333fe7d7950926dff7b7 Mon Sep 17 00:00:00 2001
From: Xavier Claessens <xavier.claessens@collabora.com>
Date: Mon, 7 Nov 2022 15:24:41 -0500
Subject: [PATCH] devenv: Document recent changes

---
 docs/markdown/Commands.md        |  2 ++
 docs/markdown/snippets/devenv.md | 15 +++++++++++++++
 2 files changed, 17 insertions(+)
 create mode 100644 docs/markdown/snippets/devenv.md

diff --git a/docs/markdown/Commands.md b/docs/markdown/Commands.md
index c3284611a..4a00c4f4c 100644
--- a/docs/markdown/Commands.md
+++ b/docs/markdown/Commands.md
@@ -345,6 +345,8 @@ These variables are set in environment in addition to those set using [[meson.ad
   schemas is compiled. This is automatically set when using `gnome.compile_schemas()`.
   Note that this requires GLib >= 2.64 when `gnome.compile_schemas()` is used in
   more than one directory.
+- `QEMU_LD_PREFIX` *Since 1.0.0* is set to the `sys_root` value from cross file
+  when cross compiling and that property is defined.
 
 Since *Since 0.62.0* if bash-completion scripts are being installed and the
 shell is bash, they will be automatically sourced.
diff --git a/docs/markdown/snippets/devenv.md b/docs/markdown/snippets/devenv.md
new file mode 100644
index 000000000..d8a38bacc
--- /dev/null
+++ b/docs/markdown/snippets/devenv.md
@@ -0,0 +1,15 @@
+## Developer environment improvements
+
+When cross compiling, the developer environment now sets all environment
+variables for the HOST machine. It now also sets `QEMU_LD_PREFIX` to the
+`sys_root` value from cross file if property is defined. That means that cross
+compiled executables can often be run transparently on the build machine, for
+example when cross compiling for aarch64 linux from x86_64 linux.
+
+A new argument `--workdir` has been added, by default it is set to build
+directory. For example, `meson devenv -C builddir --workdir .` can be used to
+remain in the current dir (often source dir) instead.
+
+`--dump` now prints shell commands like `FOO="/prepend/path:$FOO:/append/path"`,
+using the litteral `$FOO` instead of current value of `FOO` from environment.
+This makes easier to evaluate those expressions in a different environment.