manifests: use modern os facts

[puppet-modules/puppetlabs-apt.git] / REFERENCE.md

diff --git a/REFERENCE.md b/REFERENCE.md
index f605df1c90b72b60ef0fe57e03a4036cfdc9c918..13f5f9ae5e9442e380e8f3055e97fba677743d6d 100644 (file)
--- a/REFERENCE.md
+++ b/REFERENCE.md
@@ -288,6 +288,14 @@ A hash made up of the various configuration files used by Apt.
 
 Default value: `$apt::params::config_files`
 
+##### `sources_list_force`
+
+Data type: `Boolean`
+
+Specifies whether to perform force purge or delete. Default false.
+
+Default value: `$apt::params::sources_list_force`
+
 ##### `update_defaults`
 
 Data type: `Hash`
@@ -342,10 +350,10 @@ Manages backports.
 
 #### Examples
 
-##### Set up a backport for linuxmint qiana
+##### Set up a backport source for Linux Mint qiana
 
 ```puppet
-apt::backports { 'qiana':
+class { 'apt::backports':
   location => 'http://us.archive.ubuntu.com/ubuntu',
   release  => 'trusty-backports',
   repos    => 'main universe multiverse restricted',
@@ -378,7 +386,7 @@ Default value: ``undef``
 Data type: `Optional[String]`
 
 Specifies a distribution of the Apt repository containing the backports to manage. Used in populating the `source.list` configuration file.
-Default: on Debian and Ubuntu, '${lsbdistcodename}-backports'. We recommend keeping this default, except on other operating
+Default: on Debian and Ubuntu, `${facts['os']['distro']['codename']}-backports`. We recommend keeping this default, except on other operating
 systems.
 
 Default value: ``undef``
@@ -721,19 +729,19 @@ Default value: `$::apt::ppa_options`
 
 Data type: `Optional[String]`
 
-Optional if lsb-release is installed (unless you're using a different release than indicated by lsb-release, e.g., Linux Mint).
 Specifies the operating system of your node. Valid options: a string containing a valid LSB distribution codename.
+Optional if `puppet facts show os.distro.codename` returns your correct distribution release codename.
 
-Default value: `$facts['lsbdistcodename']`
+Default value: `$facts['os']['distro']['codename']`
 
 ##### `dist`
 
 Data type: `Optional[String]`
 
-Optional if lsb-release is installed (unless you're using a different release than indicated by lsb-release, e.g., Linux Mint).
 Specifies the distribution of your node. Valid options: a string containing a valid distribution codename.
+Optional if `puppet facts show os.name` returns your correct distribution name.
 
-Default value: `$facts['lsbdistid']`
+Default value: `$facts['os']['name']`
 
 ##### `package_name`