Allow setting method/separator in environment() and meson.add_devenv()

1 files changed, 22 insertions, 1 deletions

diff --git a/docs/yaml/functions/environment.yaml b/docs/yaml/functions/environment.yaml
index 99c8a45..5fb81e3 100644
--- a/docs/yaml/functions/environment.yaml
+++ b/docs/yaml/functions/environment.yaml
@@ -5,8 +5,29 @@ description: Returns an empty [[@env]] object.
 
 optargs:
   env:
-    type: dict[str]
+    type: str | list[str] | dict[str] | dict[list[str]]
     since: 0.52.0
     description: |
       If provided, each key/value pair is added into the [[@env]] object
       as if [[env.set]] method was called for each of them.
+      Since *0.62.0* list of strings is allowed in dictionnary values. In that
+      case values are joined using the separator.
+
+kwargs:
+  separator:
+    type: str
+    since: 0.62.0
+    description: |
+      The separator to use for the initial values defined in
+      the first positional argument. If not explicitly specified, the default
+      path separator for the host operating system will be used, i.e. ';' for
+      Windows and ':' for UNIX/POSIX systems.
+
+  method:
+    type: str
+    since: 0.62.0
+    description: |
+      Must be one of 'set', 'prepend', or 'append'
+      (defaults to 'set'). Controls if initial values defined in the first
+      positional argument are prepended, appended or repace the current value
+      of the environment variable.