Precision on file name format in preferences.d directory

Signed-off-by: Gabriel Filion <lelutin@gmail.com>

diff --git a/README b/README
index 80940916e9efca0e8f603ca203182886f8d1f80a..e3ce7d87193a8146a5c40dc5172f520ddeb90951 100644 (file)
--- a/README
+++ b/README
@@ -302,7 +302,7 @@ Example:
 apt::preferences_snippet
 ------------------------
 
-A way to add pinning information to /etc/apt/preferences
+A way to add pinning information to files in /etc/apt/preferences.d/
 
 Example:
 
@@ -325,6 +325,17 @@ Example:
       priority => 999;
   }
 
+The names of the resources will be used as the names of the files in the
+preferences.d directory, so you should ensure that resource names follow the
+prescribed naming scheme.
+
+From apt_preferences(5):
+     Note that the files in the /etc/apt/preferences.d directory are parsed in
+     alphanumeric ascending order and need to obey the following naming
+     convention: The files have no or "pref" as filename extension and which
+     only contain alphanumeric, hyphen (-), underscore (_) and period (.)
+     characters - otherwise they will be silently ignored.
+
 apt::preseeded_package
 ----------------------