home-environment: describe session variable trickyness

This commit is contained in:
Robert Helgesson 2018-01-04 11:59:58 +01:00
parent 8ab6298f30
commit 33af9948e5
No known key found for this signature in database
GPG key ID: C3DB11069E65DC86

View file

@ -127,6 +127,25 @@ in
example = { EDITOR = "emacs"; GS_OPTIONS = "-sPAPERSIZE=a4"; };
description = ''
Environment variables to always set at login.
</para><para>
Note, these variables may be set in any order so no session
variable may have a runtime dependency on another session
variable. In particular code like
<programlisting>
home.sessionVariables = {
FOO = "Hello";
BAR = "$FOO World!";
};
</programlisting>
may not work as expected. If you need to reference another
session variable, then do so inside Nix instead. The above
example then becomes
<programlisting>
home.sessionVariables = {
FOO = "Hello";
BAR = "''${config.home.sessionVariables.FOO} World!";
};
</programlisting>
'';
};