From: Kay Sievers <kay.sievers@vrfy.org>
Date: Tue, 22 Nov 2011 22:51:17 +0000 (+0100)
Subject: man: clarify 'config file stack'
X-Git-Tag: 176~65
X-Git-Url: http://www.chiark.greenend.org.uk/ucgi/~ianmdlvl/git?p=elogind.git;a=commitdiff_plain;h=1021e6dfcc339728d83bfa5a3e8cd73bb37dbcef

man: clarify 'config file stack'
---

diff --git a/udev/udev.xml b/udev/udev.xml
index a78534855..ab82012ce 100644
--- a/udev/udev.xml
+++ b/udev/udev.xml
@@ -71,14 +71,18 @@
 
     <refsect2><title>Rules files</title>
       <para>The udev rules are read from the files located in the
-      default rules directory <filename>/lib/udev/rules.d/</filename>,
-      the custom rules directory <filename>/etc/udev/rules.d/</filename>
-      and the temporary rules directory <filename>/run/udev/rules.d/</filename>.
-      All rule files are collectively sorted and processed in lexical order,
-      regardless of the directories in which they live. However, files in
-      <filename>/etc/udev/rules.d/</filename> take precedence over files with
-      the same name in <filename>/lib/udev/rules.d/</filename>; this can be
-      used to ignore a default rules file if needed.</para>
+      system rules directory <filename>/lib/udev/rules.d/</filename>,
+      the local administration directory <filename>/etc/udev/rules.d/</filename>
+      and the volatile runtime directory <filename>/run/udev/rules.d/</filename>.
+      All rules files are collectively sorted and processed in lexical order,
+      regardless of the directories in which they live. However, files with
+      identical file names replace each other. Files in <filename>/run</filename>
+      have the highest priority, files in <filename>/etc</filename> take precedence
+      over files with the same name in <filename>/lib</filename>. This can be
+      used to overwrite a system rules file if needed; a symlink in
+      <filename>/etc</filename> with the same name as a rules file in
+      <filename>/lib</filename>, pointing to <filename>/dev/null</filename>,
+      disables the rules file entirely.</para>
 
       <para>Rule files must have the extension <filename>.rules</filename>; other
       extensions are ignored.</para>