From 4bfa4760190d309ec93973b959518563349ec8fa Mon Sep 17 00:00:00 2001 From: memsharded Date: Fri, 12 Dec 2025 09:48:13 +0100 Subject: [PATCH 1/2] env unset docs --- reference/config_files/profiles.rst | 7 +++++++ 1 file changed, 7 insertions(+) diff --git a/reference/config_files/profiles.rst b/reference/config_files/profiles.rst index 4023505293b..98f05d49eab 100644 --- a/reference/config_files/profiles.rst +++ b/reference/config_files/profiles.rst @@ -275,6 +275,9 @@ when you're composing profiles or even local variables: * ``=+`` == ``prepend``: puts values at the beginning of the existing value. * ``=!`` == ``unset``: gets rid of any variable value. +Note that it is different to define an empy variable, like ``MyVar1=``, which defines it with a value of an empty string, +that requesting it to be explicitly unset with the ``MyVar1=!`` syntax. + Another essential point to mention is the possibility of defining variables as `PATH` ones by simply putting ``(path)`` as the prefix of the variable. It is useful to automatically get the append/prepend of the `PATH` in different systems (Windows uses ``;`` as separation, and UNIX ``:``). @@ -289,6 +292,9 @@ the prefix of the variable. It is useful to automatically get the append/prepend # Append another value to "MyVar1" MyVar1+=MyValue12 + # Define a variable with an empty string value + MyVar2= + # Define a PATH variable "MyPath1" MyPath1=(path)/some/path11 @@ -302,6 +308,7 @@ the prefix of the variable. It is useful to automatically get the append/prepend Then, the result of applying this profile is: * ``MyVar1``: ``My Value; other MyValue12`` +* ``MyVar2``: An empty string value * ``MyPath1``: * Unix: ``/other path/path12:/some/path11`` * Windows: ``/other path/path12;/some/path11`` From cdd927be4053b8e7b8854c04c315e8c148cd89a5 Mon Sep 17 00:00:00 2001 From: Carlos Zoido Date: Fri, 12 Dec 2025 09:54:38 +0100 Subject: [PATCH 2/2] Update reference/config_files/profiles.rst --- reference/config_files/profiles.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/reference/config_files/profiles.rst b/reference/config_files/profiles.rst index 98f05d49eab..d58b5f7b104 100644 --- a/reference/config_files/profiles.rst +++ b/reference/config_files/profiles.rst @@ -275,7 +275,7 @@ when you're composing profiles or even local variables: * ``=+`` == ``prepend``: puts values at the beginning of the existing value. * ``=!`` == ``unset``: gets rid of any variable value. -Note that it is different to define an empy variable, like ``MyVar1=``, which defines it with a value of an empty string, +Note that it is different to define an empty variable, like ``MyVar1=``, which defines it with a value of an empty string, that requesting it to be explicitly unset with the ``MyVar1=!`` syntax. Another essential point to mention is the possibility of defining variables as `PATH` ones by simply putting ``(path)`` as