diff options
author | Tim Smith <tsmith84@gmail.com> | 2020-04-29 14:52:47 -0700 |
---|---|---|
committer | Tim Smith <tsmith84@gmail.com> | 2020-04-29 14:52:47 -0700 |
commit | b21169152c458778a8d23b0bba5ebaafd568f364 (patch) | |
tree | 97461635bb49d7bce8349479582609ea5d530572 /lib | |
parent | d68d7eab64e47a1f42ddaffa6f8c85fec3c9830c (diff) | |
download | chef-b21169152c458778a8d23b0bba5ebaafd568f364.tar.gz |
Improve resource doc formatting
Signed-off-by: Tim Smith <tsmith@chef.io>
Diffstat (limited to 'lib')
-rw-r--r-- | lib/chef/resource/apt_package.rb | 2 | ||||
-rw-r--r-- | lib/chef/resource/apt_preference.rb | 2 | ||||
-rw-r--r-- | lib/chef/resource/apt_repository.rb | 6 | ||||
-rw-r--r-- | lib/chef/resource/apt_update.rb | 2 | ||||
-rw-r--r-- | lib/chef/resource/archive_file.rb | 4 |
5 files changed, 8 insertions, 8 deletions
diff --git a/lib/chef/resource/apt_package.rb b/lib/chef/resource/apt_package.rb index 148255c47f..9889843e26 100644 --- a/lib/chef/resource/apt_package.rb +++ b/lib/chef/resource/apt_package.rb @@ -29,7 +29,7 @@ class Chef description "Use the apt_package resource to manage packages on Debian and Ubuntu platforms." property :default_release, String, - description: "The default release. For example: stable.", + description: "The default release. For example: `stable`.", desired_state: false property :overwrite_config_files, [TrueClass, FalseClass], diff --git a/lib/chef/resource/apt_preference.rb b/lib/chef/resource/apt_preference.rb index 9a661ce37d..c4aea5d1ce 100644 --- a/lib/chef/resource/apt_preference.rb +++ b/lib/chef/resource/apt_preference.rb @@ -36,7 +36,7 @@ class Chef validation_message: "The provided package name is not valid. Package names can only contain alphanumeric characters as well as _, -, +, or *!" property :glob, String, - description: "Pin by glob() expression or with regular expressions surrounded by /." + description: "Pin by a `glob()` expression or with a regular expressions surrounded by `/`." property :pin, String, description: "The package version or repository to pin.", diff --git a/lib/chef/resource/apt_repository.rb b/lib/chef/resource/apt_repository.rb index 7e56a4b3af..1a6ea10522 100644 --- a/lib/chef/resource/apt_repository.rb +++ b/lib/chef/resource/apt_repository.rb @@ -115,15 +115,15 @@ class Chef description: "The base of the Debian distribution." property :distribution, [ String, nil, FalseClass ], - description: "Usually a distribution's codename, such as xenial, bionic, or focal.", + description: "Usually a distribution's codename, such as `xenial`, `bionic`, or `focal`.", default: lazy { node["lsb"]["codename"] }, default_description: "The LSB codename of the node such as 'focal'." property :components, Array, description: "Package groupings, such as 'main' and 'stable'.", - default: lazy { [] }, default_description: "'main' if using a PPA repository." + default: lazy { [] }, default_description: "`main` if using a PPA repository." property :arch, [String, nil, FalseClass], - description: "Constrain packages to a particular CPU architecture such as 'i386' or 'amd64'." + description: "Constrain packages to a particular CPU architecture such as `i386` or `amd64`." property :trusted, [TrueClass, FalseClass], description: "Determines whether you should treat all packages from this repository as authenticated regardless of signature.", diff --git a/lib/chef/resource/apt_update.rb b/lib/chef/resource/apt_update.rb index 2fa7c16ddb..a2ca6aa5e0 100644 --- a/lib/chef/resource/apt_update.rb +++ b/lib/chef/resource/apt_update.rb @@ -46,7 +46,7 @@ class Chef property :name, String, default: "" property :frequency, Integer, - description: "Determines how frequently (in seconds) APT repository updates are made. Use this property when the :periodic action is specified.", + description: "Determines how frequently (in seconds) APT repository updates are made. Use this property when the `:periodic` action is specified.", default: 86_400 default_action :periodic diff --git a/lib/chef/resource/archive_file.rb b/lib/chef/resource/archive_file.rb index b525286c06..b288cb4885 100644 --- a/lib/chef/resource/archive_file.rb +++ b/lib/chef/resource/archive_file.rb @@ -60,11 +60,11 @@ class Chef required: true property :options, [Array, Symbol], - description: "An array of symbols representing extraction flags. Example: :no_overwrite to prevent overwriting files on disk. By default, this properly sets :time which preserves the modification timestamps of files in the archive when writing them to disk.", + description: "An array of symbols representing extraction flags. Example: `:no_overwrite` to prevent overwriting files on disk. By default, this properly sets `:time` which preserves the modification timestamps of files in the archive when writing them to disk.", default: lazy { [:time] } property :overwrite, [TrueClass, FalseClass, :auto], - description: "Should the resource overwrite the destination file contents if they already exist? If set to :auto the date stamp of files within the archive will be compared to those on disk and disk contents will be overwritten if they differ. This may cause unintended consequences if disk date stamps are changed between runs, which will result in the files being overwritten during each client run. Make sure to properly test any change to this property.", + description: "Should the resource overwrite the destination file contents if they already exist? If set to `:auto` the date stamp of files within the archive will be compared to those on disk and disk contents will be overwritten if they differ. This may cause unintended consequences if disk date stamps are changed between runs, which will result in the files being overwritten during each client run. Make sure to properly test any change to this property.", default: false # backwards compatibility for the legacy cookbook names |