From: Benjamin Berg <bberg@redhat.com>
Date: Wed, 4 Mar 2020 10:30:31 +0000 (+0100)
Subject: man: Add documentation for generator path environment variables
X-Git-Tag: v246-rc1~787^2
X-Git-Url: http://git.ipfire.org/?a=commitdiff_plain;h=refs%2Fpull%2F14893%2Fhead;p=thirdparty%2Fsystemd.git

man: Add documentation for generator path environment variables

This adds documentation for the SYSTEMD_GENERATOR_PATH and
SYSTEMD_ENVIRONMENT_GENERATOR_PATH variables to the systemd man page
grouped with the existing SYSTEMD_UNIT_PATH.

Also added is a description about how these variables work, i.e. that a
trailing : can be used to prepend paths to the usual set.
---

diff --git a/man/systemd.xml b/man/systemd.xml
index 28bf49e131b..8b1b6e6c6b4 100644
--- a/man/systemd.xml
+++ b/man/systemd.xml
@@ -649,9 +649,17 @@
 
       <varlistentry>
         <term><varname>$SYSTEMD_UNIT_PATH</varname></term>
-
-        <listitem><para>Controls where systemd looks for unit
-        files.</para></listitem>
+        <term><varname>$SYSTEMD_GENERATOR_PATH</varname></term>
+        <term><varname>$SYSTEMD_ENVIRONMENT_GENERATOR_PATH</varname></term>
+
+        <listitem><para>Controls where systemd looks for unit files and
+        generators.</para>
+        <para>These variables may contain a list of paths, separated by colons
+        (<literal>:</literal>). When set, if the list ends with an empty
+        component (<literal>...:</literal>), this list is prepended to the
+        usual set of of paths. Otherwise, the specified list replaces the usual
+        set of paths.
+        </para></listitem>
       </varlistentry>
 
       <varlistentry>