-*- org -*-

* unset multiple vars in single instr
<2018-07-13 fri>
----------------------------------------
env unset VAR...
----------------------------------------

* unset all vars (except some specified)
<2018-07-13 fri>
Provides better control over env vars.
Removes all but the minimum needed.

----------------------------------------
env unset -all-except VAR...
----------------------------------------

Maybe should have form to unset all vars too

----------------------------------------
env unset -all
----------------------------------------

* unset: use REG-EX to unset multiple vars
----------------------------------------
env unset REG-EX...
----------------------------------------

----------------------------------------
env unset -all [-except REG-EX...]
----------------------------------------

* ability to have different set of env vars in [act] and other phases
long pre <2018-07-13 fri>
Since env vars may be part of the thing that is tested - i.e. the [act] "environment".
But other phases may depend on env vars for implementing setup and assertions etc

----------------------------------------
env -act PATH = ...
env -!act PATH = ...
env -in-act PATH = ...
env -in act PATH = ...
env -in ! act PATH = ...
env -in !act PATH = ...
env -of act PATH = ...
env -of !act PATH = ...

----------------------------------------

* ability to transform env var value using string-transformer
<2018-07-12 thu>

----------------------------------------
env VAR = -transformed-by STRING-TRANS VAL
----------------------------------------

Useful when VAL contains references to env vars,
e.g. for removing a path in PATH.

----------------------------------------
env PATH = -transformed-by STRING-TRANS ${PATH}
----------------------------------------

* multi-line values
<2018-07-15 Sun>
This instr has not been adapted to the multi-line feature.
