X-Git-Url: https://review.fuel-infra.org/gitweb?a=blobdiff_plain;f=README.md;h=20c465dbfa1eec47e5ef0ccdfc21609635c8554b;hb=543f0ccefad1554ba3bf0eab5ad2f67785b1fb8e;hp=581277bde051039e1a6a8c0f93b843f6920d2e64;hpb=a35c30fe4b501e1bce24fe120cc8cd348b914ac6;p=puppet-modules%2Fpuppetlabs-apt.git

diff --git a/README.md b/README.md
index 581277b..20c465d 100644
--- a/README.md
+++ b/README.md
@@ -273,6 +273,10 @@ Implementation
 
 Adds the necessary components to get backports for Ubuntu and Debian. The release name defaults to `$lsbdistcodename`. Setting this manually can cause undefined behavior (read: universe exploding).
 
+By default this class drops a Pin-file for Backports pinning it to a priority of 200, lower than the normal Debian archive which gets a priority of 500 to ensure your packages with `ensure => latest` don't get magically upgraded from Backports without your explicit say-so.
+
+If you raise the priority through the `pin_priority` parameter to *500*, identical to the rest of the Debian mirrors, normal policy goes into effect and the newest version wins/becomes the candidate apt will want to install or upgrade to. This means that if a package is available from Backports it and its dependencies will be pulled in from Backports unless you explicitly set the `ensure` attribute of the `package` resource to `installed`/`present` or a specific version.
+
 Limitations
 -----------