aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
Diffstat (limited to 'tasks-reference/environment/text.xml')
-rw-r--r--tasks-reference/environment/text.xml32
1 files changed, 32 insertions, 0 deletions
diff --git a/tasks-reference/environment/text.xml b/tasks-reference/environment/text.xml
new file mode 100644
index 0000000..f6eea7a
--- /dev/null
+++ b/tasks-reference/environment/text.xml
@@ -0,0 +1,32 @@
+<?xml version="1.0"?>
+<guide self="tasks-reference/environment/">
+<chapter>
+<title>Environment Files</title>
+
+<body>
+
+<p>
+Some packages need to globally set an environment variable for all users. The
+canonical way of doing this is via <c>/etc/env.d</c>. All files in this directory
+are sourced when generating user environment settings.
+</p>
+
+<p>
+This directory should <b>only</b> be used for setting environment variables.
+</p>
+
+<p>
+To install a file into this directory, use <c>doenvd</c> or <c>newenvd</c> (see
+`Install Functions Reference`_). The format of the file should be a series of
+lines in the form <c>VARIABLE="the value"</c>.
+</p>
+
+<p>
+There is further discussion in the <uri
+link="http://www.gentoo.org/doc/en/handbook/handbook-x86.xml?part=2&amp;chap=5">
+Environment Variables section</uri>.
+</p>
+
+</body>
+</chapter>
+</guide>