From: Tobias Ulmer <tu@emlix.com>
Date: Thu, 27 Oct 2016 17:46:42 +0000 (+0200)
Subject: manpage: document 'env' a little better
X-Git-Tag: e2factory-2.3.15rc1~41
X-Git-Url: https://git.e2factory.org/?a=commitdiff_plain;h=021097178681b7913994aa0e7451df8d896f98d1;p=e2factory.git

manpage: document 'env' a little better

Signed-off-by: Tobias Ulmer <tu@emlix.com>
---

diff --git a/doc/man/e2env.5.in b/doc/man/e2env.5.in
index 41f9e2b..c373dd7 100644
--- a/doc/man/e2env.5.in
+++ b/doc/man/e2env.5.in
@@ -1,15 +1,15 @@
 .\" Man page for e2env
 .\"
-.\" (c)2007 emlix GmbH
+.\" (c)2007-2016 emlix GmbH
 .\"
-.TH e2env 5 "Oct 26, 2012" "@VERSION@"
+.TH e2env 5 "@VERSION@"
 
 .SH NAME
 proj/env \- optional configuration file for environment variable of build processes
 
 .SH DESCRIPTION
 The optional file \fBproj/env\fR defines tables of global and result-specific
-environment variables that will be available during build processes. 
+environment variables that will be available during build processes.
 
 .SH STRUCTURE
 \fBGlobal environment variables:\fR
@@ -18,7 +18,6 @@ environment variables that will be available during build processes.
 env {
   <variable1> = "<value1>",
   <variable2> = "<value2>",
-  :
 }
 .fi
 
@@ -26,21 +25,32 @@ env {
 
 .nf
 env {
-  :
   ["<resultname>"] = { <variable1 = "<value1>", ... }
-  :
+}
+.fi
+
+\fBAccessing previously defined variables via env:\fR
+
+.nf
+env {
+  ["<resultname>"] = { <variable1 = "<value1>", ... }
+}
+
+env {
+  ["<anotherresult>"] = env["<resultname>"],
+  <variable2> = env.<variable1>,
 }
 .fi
 
 \fBInclude a file:\fR
 
-env("<file>")
+env "<file>"
 
-<file> needs to be relative from project root. Syntax is the same as above.
+<file> needs to be relative to the project root. Syntax is the same as above.
 
 
 .SH "SEE ALSO"
 .BR e2factory(1)
 
 .SH COPYRIGHT
-(c)2013 emlix GmbH
+(c)2007-2016 emlix GmbH