From 0cf4c0d1414a0110d420e7b4b1c2f645be811738 Mon Sep 17 00:00:00 2001
From: Chris Atkinson <christopher.william.atkinson@gmail.com>
Date: Thu, 17 Dec 2015 22:41:59 -0500
Subject: [PATCH] man: describe precedence of drop-in .conf files over unit
 files

---
 man/systemd.unit.xml | 12 ++++++++++++
 1 file changed, 12 insertions(+)

diff --git a/man/systemd.unit.xml b/man/systemd.unit.xml
index 5b12378eda6..9b7013e0ce4 100644
--- a/man/systemd.unit.xml
+++ b/man/systemd.unit.xml
@@ -191,6 +191,17 @@
     <literal>.d/</literal> subdirectory and reads its
     <literal>.conf</literal> files.</para>
 
+    <para>In addition to <filename>/etc/systemd/system</filename>,
+    the drop-in <literal>.conf</literal> files for system services
+    can be placed in <filename>/usr/lib/systemd/system</filename> or
+    <filename>/run/systemd/system</filename> directories. Drop-in
+    files in <filename>/etc</filename> take precedence over those in
+    <filename>/run</filename> which in turn take precedence over
+    those in <filename>/usr/lib</filename>. Drop-in files under any of
+    these directories take precedence over unit files wherever located.
+    (Of course, since <filename>/run</filename> is temporary and
+    <filename>/usr/lib</filename> is for vendors, it is unlikely
+    drop-ins should be used in either of those places.)</para>
     <!-- Note that we do not document .include here, as we
          consider it mostly obsolete, and want people to
          use .d/ drop-ins instead. -->
@@ -1402,6 +1413,7 @@ PrivateTmp=yes</programlisting>
       cannot be reset to an empty list, so dependencies can only be
       added in drop-ins. If you want to remove dependencies, you have
       to override the entire unit.</para>
+
     </example>
   </refsect1>