chef 16.0.257-universal-mingw32 → 16.0.275-universal-mingw32

data/lib/chef/resource/openssl_rsa_public_key.rb

@@ -47,7 +47,7 @@ class Chef
         ```
       DOC
 
-      description "Use the openssl_rsa_public_key resource to generate RSA public key files for a given RSA private key."
+      description "Use the **openssl_rsa_public_key** resource to generate RSA public key files for a given RSA private key."
       introduced "14.0"
 
       property :path, String,

data/lib/chef/resource/openssl_x509_certificate.rb

@@ -27,7 +27,7 @@ class Chef
       provides :openssl_x509_certificate
       provides(:openssl_x509) { true } # legacy cookbook name.
 
-      description "Use the openssl_x509_certificate resource to generate signed or self-signed, PEM-formatted x509 certificates. If no existing key is specified, the resource will automatically generate a passwordless key with the certificate. If a CA private key and certificate are provided, the certificate will be signed with them. Note: This resource was renamed from openssl_x509 to openssl_x509_certificate. The legacy name will continue to function, but cookbook code should be updated for the new resource name."
+      description "Use the **openssl_x509_certificate** resource to generate signed or self-signed, PEM-formatted x509 certificates. If no existing key is specified, the resource will automatically generate a passwordless key with the certificate. If a CA private key and certificate are provided, the certificate will be signed with them. Note: This resource was renamed from openssl_x509 to openssl_x509_certificate. The legacy name will continue to function, but cookbook code should be updated for the new resource name."
       introduced "14.4"
       examples <<~DOC
         Create a simple self-signed certificate file

data/lib/chef/resource/openssl_x509_crl.rb

@@ -26,7 +26,7 @@ class Chef
 
       provides :openssl_x509_crl
 
-      description "Use the openssl_x509_crl resource to generate PEM-formatted x509 certificate revocation list (CRL) files."
+      description "Use the **openssl_x509_crl** resource to generate PEM-formatted x509 certificate revocation list (CRL) files."
       introduced "14.4"
       examples <<~DOC
         Generate a CRL file given a cert file and key file

data/lib/chef/resource/openssl_x509_request.rb

@@ -26,7 +26,7 @@ class Chef
 
       provides :openssl_x509_request
 
-      description "Use the openssl_x509_request resource to generate PEM-formatted x509 certificates requests. If no existing key is specified, the resource will automatically generate a passwordless key with the certificate."
+      description "Use the **openssl_x509_request** resource to generate PEM-formatted x509 certificates requests. If no existing key is specified, the resource will automatically generate a passwordless key with the certificate."
       introduced "14.4"
       examples <<~DOC
         Generate new ec key and csr file

data/lib/chef/resource/osx_profile.rb

@@ -26,7 +26,7 @@ class Chef
       provides :osx_profile
       provides :osx_config_profile
 
-      description "Use the osx_profile resource to manage configuration profiles (.mobileconfig files) on the macOS platform. The osx_profile resource installs profiles by using the uuidgen library to generate a unique ProfileUUID, and then using the profiles command to install the profile on the system."
+      description "Use the **osx_profile** resource to manage configuration profiles (.mobileconfig files) on the macOS platform. The osx_profile resource installs profiles by using the uuidgen library to generate a unique ProfileUUID, and then using the profiles command to install the profile on the system."
       introduced "12.7"
 
       default_action :install

data/lib/chef/resource/package.rb

@@ -25,7 +25,7 @@ class Chef
       unified_mode true
       provides :package
 
-      description "Use the package resource to manage packages. When the package is"\
+      description "Use the **package** resource to manage packages. When the package is"\
                   " installed from a local file (such as with RubyGems, dpkg, or RPM"\
                   " Package Manager), the file must be added to the node using the remote_file"\
                   " or cookbook_file resources.\n\nThis resource is the base resource for"\

data/lib/chef/resource/pacman_package.rb

@@ -25,7 +25,7 @@ class Chef
 
       provides :pacman_package
 
-      description "Use the pacman_package resource to manage packages (using pacman) on the Arch Linux platform."
+      description "Use the **pacman_package** resource to manage packages (using pacman) on the Arch Linux platform."
     end
   end
 end

data/lib/chef/resource/paludis_package.rb

@@ -26,7 +26,7 @@ class Chef
 
       provides :paludis_package
 
-      description "Use the paludis_package resource to manage packages for the Paludis platform."
+      description "Use the **paludis_package** resource to manage packages for the Paludis platform."
       introduced "12.1"
 
       allowed_actions :install, :remove, :upgrade

data/lib/chef/resource/perl.rb

@@ -31,7 +31,7 @@ class Chef
         @interpreter = "perl"
       end
 
-      description "Use the perl resource to execute scripts using the Perl interpreter."\
+      description "Use the **perl** resource to execute scripts using the Perl interpreter."\
                   " This resource may also use any of the actions and properties that are"\
                   " available to the execute resource. Commands that are executed with this"\
                   " resource are (by their nature) not idempotent, as they are typically"\

data/lib/chef/resource/plist.rb

@@ -26,7 +26,7 @@ class Chef
 
       provides :plist
 
-      description "Use the plist resource to set config values in plist files on macOS systems."
+      description "Use the **plist** resource to set config values in plist files on macOS systems."
       introduced "16.0"
 
       property :path, String, name_property: true

data/lib/chef/resource/portage_package.rb

@@ -25,7 +25,7 @@ class Chef
 
       provides :portage_package
 
-      description "Use the portage_package resource to manage packages for the Gentoo platform."
+      description "Use the **portage_package** resource to manage packages for the Gentoo platform."
 
       property :package_name, String,
         description: "An optional property to set the package name if it differs from the resource block's name.",

data/lib/chef/resource/powershell_package.rb

@@ -24,7 +24,7 @@ class Chef
 
       provides :powershell_package
 
-      description "Use the powershell_package resource to install and manage packages via the PowerShell Package Manager for the Microsoft Windows platform. The powershell_package resource requires administrative access, and a source must be configured in the PowerShell Package Manager via the powershell_package_source resource."
+      description "Use the **powershell_package** resource to install and manage packages via the PowerShell Package Manager for the Microsoft Windows platform. The powershell_package resource requires administrative access, and a source must be configured in the PowerShell Package Manager via the powershell_package_source resource."
       introduced "12.16"
 
       allowed_actions :install, :remove

data/lib/chef/resource/powershell_package_source.rb

@@ -25,7 +25,7 @@ class Chef
 
       provides :powershell_package_source
 
-      description "Use the powershell_package_source resource to register a PowerShell package repository."
+      description "Use the **powershell_package_source** resource to register a PowerShell package repository."
       introduced "14.3"
 
       property :source_name, String,

data/lib/chef/resource/powershell_script.rb

@@ -39,7 +39,7 @@ class Chef
           end
         }
 
-      description "Use the powershell_script resource to execute a script using the Windows PowerShell"\
+      description "Use the **powershell_script** resource to execute a script using the Windows PowerShell"\
                   " interpreter, much like how the script and script-based resources—bash, csh, perl, python,"\
                   " and ruby—are used. The powershell_script is specific to the Microsoft Windows platform"\
                   " and the Windows PowerShell interpreter.\n\n The powershell_script resource creates and"\

data/lib/chef/resource/python.rb

@@ -30,7 +30,7 @@ class Chef
         @interpreter = "python"
       end
 
-      description "Use the python resource to execute scripts using the Python interpreter."\
+      description "Use the **python** resource to execute scripts using the Python interpreter."\
                   " This resource may also use any of the actions and properties that are available"\
                   " to the execute resource. Commands that are executed with this resource are (by"\
                   " their nature) not idempotent, as they are typically unique to the environment in"\

data/lib/chef/resource/reboot.rb

@@ -26,7 +26,7 @@ class Chef
 
       provides :reboot
 
-      description "Use the reboot resource to reboot a node, a necessary step with some"\
+      description "Use the **reboot** resource to reboot a node, a necessary step with some"\
                   " installations on certain platforms. This resource is supported for use on"\
                   " the Microsoft Windows, macOS, and Linux platforms.\n"\
                   "In using this resource via notifications, it's important to *only* use"\

data/lib/chef/resource/registry_key.rb

@@ -26,7 +26,7 @@ class Chef
 
       provides(:registry_key) { true }
 
-      description "Use the registry_key resource to create and delete registry keys in Microsoft Windows."
+      description "Use the **registry_key** resource to create and delete registry keys in Microsoft Windows."
       introduced "11.0"
 
       state_attrs :values

data/lib/chef/resource/remote_directory.rb

@@ -29,7 +29,7 @@ class Chef
 
       provides :remote_directory
 
-      description "Use the remote_directory resource to incrementally transfer a directory from a cookbook to a node. The director that is copied from the cookbook should be located under COOKBOOK_NAME/files/default/REMOTE_DIRECTORY. The remote_directory resource will obey file specificity."
+      description "Use the **remote_directory** resource to incrementally transfer a directory from a cookbook to a node. The director that is copied from the cookbook should be located under COOKBOOK_NAME/files/default/REMOTE_DIRECTORY. The remote_directory resource will obey file specificity."
 
       default_action :create
       allowed_actions :create, :create_if_missing, :delete

data/lib/chef/resource/remote_file.rb

@@ -31,8 +31,7 @@ class Chef
 
       provides :remote_file
 
-      description "Use the remote_file resource to transfer a file from a remote location"\
-                  " using file specificity. This resource is similar to the file resource."
+      description "Use the **remote_file** resource to transfer a file from a remote location using file specificity. This resource is similar to the file resource."
 
       def initialize(name, run_context = nil)
         super

data/lib/chef/resource/rhsm_errata.rb

@@ -23,9 +23,7 @@ class Chef
       unified_mode true
       provides(:rhsm_errata) { true }
 
-      description "Use the rhsm_errata resource to install packages associated with a given Red"\
-                  " Hat Subscription Manager Errata ID. This is helpful if packages"\
-                  " to mitigate a single vulnerability must be installed on your hosts."
+      description "Use the **rhsm_errata** resource to install packages associated with a given Red Hat Subscription Manager Errata ID. This is helpful if packages to mitigate a single vulnerability must be installed on your hosts."
       introduced "14.0"
 
       property :errata_id, String,

data/lib/chef/resource/rhsm_errata_level.rb

@@ -23,7 +23,7 @@ class Chef
       unified_mode true
       provides(:rhsm_errata_level) { true }
 
-      description "Use the rhsm_errata_level resource to install all packages of a specified errata level from the Red Hat Subscription Manager. For example, you can ensure that all packages associated with errata marked at a 'Critical' security level are installed."
+      description "Use the **rhsm_errata_level** resource to install all packages of a specified errata level from the Red Hat Subscription Manager. For example, you can ensure that all packages associated with errata marked at a 'Critical' security level are installed."
       introduced "14.0"
 
       property :errata_level, String,

data/lib/chef/resource/rhsm_register.rb

@@ -25,8 +25,7 @@ class Chef
       unified_mode true
       provides(:rhsm_register) { true }
 
-      description "Use the rhsm_register resource to register a node with the Red Hat Subscription Manager"\
-                  " or a local Red Hat Satellite server."
+      description "Use the **rhsm_register** resource to register a node with the Red Hat Subscription Manager or a local Red Hat Satellite server."
       introduced "14.0"
 
       property :activation_key, [String, Array],

data/lib/chef/resource/rhsm_repo.rb

@@ -24,8 +24,7 @@ class Chef
 
       provides(:rhsm_repo) { true }
 
-      description "Use the rhsm_repo resource to enable or disable Red Hat Subscription Manager"\
-                  " repositories that are made available via attached subscriptions."
+      description "Use the **rhsm_repo** resource to enable or disable Red Hat Subscription Manager repositories that are made available via attached subscriptions."
       introduced "14.0"
 
       property :repo_name, String,

data/lib/chef/resource/rhsm_subscription.rb

@@ -24,9 +24,7 @@ class Chef
 
       provides(:rhsm_subscription) { true }
 
-      description "Use the rhsm_subscription resource to add or remove Red Hat Subscription Manager"\
-                  " subscriptions from your host. This can be used when a host's activation_key"\
-                  " does not attach all necessary subscriptions to your host."
+      description "Use the **rhsm_subscription** resource to add or remove Red Hat Subscription Manager subscriptions from your host. This can be used when a host's activation_key does not attach all necessary subscriptions to your host."
       introduced "14.0"
 
       property :pool_id, String,

data/lib/chef/resource/route.rb

@@ -29,7 +29,7 @@ class Chef
       default_action :add
       allowed_actions :add, :delete
 
-      description "Use the route resource to manage the system routing table in a Linux environment."
+      description "Use the **route** resource to manage the system routing table in a Linux environment."
 
       property :target, String,
         description: "The IP address of the target route.",

data/lib/chef/resource/rpm_package.rb

@@ -25,9 +25,12 @@ class Chef
 
       provides :rpm_package
 
-      description "Use the rpm_package resource to manage packages using the RPM Package Manager."
+      description "Use the **rpm_package** resource to manage packages using the RPM Package Manager."
 
-      property :allow_downgrade, [ true, false ], default: true, desired_state: false
+      property :allow_downgrade, [ TrueClass, FalseClass ],
+        description: "Allow downgrading a package to satisfy requested version requirements.",
+        default: true,
+        desired_state: false
 
       property :package_name, String,
         description: "An optional property to set the package name if it differs from the resource block's name.",

data/lib/chef/resource/ruby.rb

@@ -26,7 +26,7 @@ class Chef
 
       provides :ruby
 
-      description "Use the ruby resource to execute scripts using the Ruby interpreter. This"\
+      description "Use the **ruby** resource to execute scripts using the Ruby interpreter. This"\
                   " resource may also use any of the actions and properties that are available"\
                   " to the execute resource. Commands that are executed with this resource are (by"\
                   " their nature) not idempotent, as they are typically unique to the environment"\

data/lib/chef/resource/ruby_block.rb

@@ -28,10 +28,7 @@ class Chef
 
       provides :ruby_block, target_mode: true
 
-      description "Use the ruby_block resource to execute Ruby code during a #{Chef::Dist::PRODUCT} run."\
-                  " Ruby code in the ruby_block resource is evaluated with other resources during"\
-                  " convergence, whereas Ruby code outside of a ruby_block resource is evaluated"\
-                  " before other resources, as the recipe is compiled."
+      description "Use the **ruby_block** resource to execute Ruby code during a #{Chef::Dist::PRODUCT} run. Ruby code in the ruby_block resource is evaluated with other resources during convergence, whereas Ruby code outside of a ruby_block resource is evaluated before other resources, as the recipe is compiled."
 
       default_action :run
       allowed_actions :create, :run

data/lib/chef/resource/scm/_scm.rb

@@ -25,17 +25,18 @@ property :destination, String,
   description: "The location path to which the source is to be cloned, checked out, or exported. Default value: the name of the resource block.",
   name_property: true
 
-property :repository, String
+property :repository, String,
+  description: "The URI of the code repository."
 
 property :revision, String,
   description: "The revision to checkout.",
   default: "HEAD"
 
 property :user, [String, Integer],
-  description: "The system user that should own the checked-out code."
+  description: "The system user that will own the checked-out code."
 
 property :group, [String, Integer],
-  description: "The system group that should own the checked-out code."
+  description: "The system group that will own the checked-out code."
 
 property :timeout, Integer,
   description: "The amount of time (in seconds) to wait before timing out.",

data/lib/chef/resource/scm/git.rb

@@ -27,7 +27,7 @@ class Chef
 
       provides :git
 
-      description "Use the git resource to manage source control resources that exist in a git repository. git version 1.6.5 (or higher) is required to use all of the functionality in the git resource."
+      description "Use the **git** resource to manage source control resources that exist in a git repository. git version 1.6.5 (or higher) is required to use all of the functionality in the git resource."
 
       property :additional_remotes, Hash,
         description: "A Hash of additional remotes that are added to the git repository configuration.",

data/lib/chef/resource/scm/subversion.rb

@@ -28,7 +28,7 @@ class Chef
 
       provides :subversion
 
-      description "Use the subversion resource to manage source control resources that exist in a Subversion repository."
+      description "Use the **subversion** resource to manage source control resources that exist in a Subversion repository."
 
       allowed_actions :force_export
 
@@ -38,7 +38,7 @@ class Chef
         default: "--no-auth-cache"
 
       property :svn_info_args, [String, nil, FalseClass],
-        description: "Use when the svn info command is used by the #{Chef::Dist::CLIENT} and arguments need to be passed. The svn_arguments command does not work when the svn info command is used.",
+        description: "Use when the `svn info` command is used by #{Chef::Dist::PRODUCT} and arguments need to be passed. The `svn_arguments` command does not work when the `svn info` command is used.",
         coerce: proc { |v| v == false ? nil : v }, # coerce false to nil
         default: "--no-auth-cache"
 

data/lib/chef/resource/script.rb

@@ -28,7 +28,7 @@ class Chef
 
       identity_attr :name
 
-      description "Use the script resource to execute scripts using a specified interpreter, such as Bash, csh, Perl, Python, or Ruby."\
+      description "Use the **script** resource to execute scripts using a specified interpreter, such as Bash, csh, Perl, Python, or Ruby."\
                   " This resource may also use any of the actions and properties that are available to the execute resource. Commands"\
                   " that are executed with this resource are (by their nature) not idempotent, as they are typically unique to the"\
                   " environment in which they are run. Use not_if and only_if to guard this resource for idempotence."

data/lib/chef/resource/service.rb

@@ -31,7 +31,7 @@ class Chef
 
       provides :service, target_mode: true
 
-      description "Use the service resource to manage a service."
+      description "Use the **service** resource to manage a service."
 
       default_action :nothing
       allowed_actions :enable, :disable, :start, :stop, :restart, :reload,

data/lib/chef/resource/smartos_package.rb

@@ -26,7 +26,7 @@ class Chef
       provides :smartos_package
       provides :package, platform_family: "smartos"
 
-      description "Use the smartos_package resource to manage packages for the SmartOS platform."
+      description "Use the **smartos_package** resource to manage packages for the SmartOS platform."
 
       property :package_name, String,
         description: "An optional property to set the package name if it differs from the resource block's name.",

data/lib/chef/resource/snap_package.rb

@@ -25,7 +25,7 @@ class Chef
 
       provides :snap_package
 
-      description "Use the snap_package resource to manage snap packages on Debian and Ubuntu platforms."
+      description "Use the **snap_package** resource to manage snap packages on Debian and Ubuntu platforms."
       introduced "15.0"
 
       property :channel, String,

data/lib/chef/resource/solaris_package.rb

@@ -28,7 +28,7 @@ class Chef
       provides :package, os: "solaris2", platform_family: "nexentacore"
       provides :package, os: "solaris2", platform_family: "solaris2", platform_version: "<= 5.10"
 
-      description "The solaris_package resource is used to manage packages for the Solaris platform."
+      description "Use the **solaris_package** resource to manage packages on the Solaris platform."
 
       property :package_name, String,
         description: "An optional property to set the package name if it differs from the resource block's name.",

data/lib/chef/resource/ssh_known_hosts_entry.rb

@@ -27,7 +27,7 @@ class Chef
 
       provides :ssh_known_hosts_entry
 
-      description "Use the ssh_known_hosts_entry resource to add an entry for the specified host in /etc/ssh/ssh_known_hosts or a user's known hosts file if specified."
+      description "Use the **ssh_known_hosts_entry** resource to add an entry for the specified host in /etc/ssh/ssh_known_hosts or a user's known hosts file if specified."
       introduced "14.3"
 
       property :host, String,

data/lib/chef/resource/sudo.rb

@@ -28,7 +28,7 @@ class Chef
 
       provides(:sudo) { true }
 
-      description "Use the sudo resource to add or remove individual sudo entries using sudoers.d files."\
+      description "Use the **sudo** resource to add or remove individual sudo entries using sudoers.d files."\
                   " Sudo version 1.7.2 or newer is required to use the sudo resource, as it relies on the"\
                   " '#includedir' directive introduced in version 1.7.2. This resource does not enforce"\
                   " installation of the required sudo version. Chef-supported releases of Ubuntu, SuSE, Debian,"\
@@ -88,15 +88,15 @@ class Chef
         default: lazy { [] }
 
       property :setenv, [TrueClass, FalseClass],
-        description: "Determines whether or not to permit preservation of the environment with 'sudo -E'.",
+        description: "Determines whether or not to permit preservation of the environment with `sudo -E`.",
         default: false
 
       property :env_keep_add, Array,
-        description: "An array of strings to add to env_keep.",
+        description: "An array of strings to add to `env_keep`.",
         default: lazy { [] }
 
       property :env_keep_subtract, Array,
-        description: "An array of strings to remove from env_keep.",
+        description: "An array of strings to remove from `env_keep`.",
         default: lazy { [] }
 
       property :visudo_path, String,

data/lib/chef/resource/swap_file.rb

@@ -24,7 +24,7 @@ class Chef
 
       provides(:swap_file) { true }
 
-      description "Use the swap_file resource to create or delete swap files on Linux systems, and optionally to manage the swappiness configuration for a host."
+      description "Use the **swap_file** resource to create or delete swap files on Linux systems, and optionally to manage the swappiness configuration for a host."
       introduced "14.0"
 
       property :path, String,
@@ -39,7 +39,7 @@ class Chef
         default: false
 
       property :timeout, Integer,
-        description: "Timeout for 'dd' / 'fallocate' commands.",
+        description: "Timeout for `dd` / `fallocate` commands.",
         default: 600,
         desired_state: false