From 198adcec78affb0d6c820bf0449ac60b29f517d7 Mon Sep 17 00:00:00 2001 From: Tim Smith Date: Thu, 23 Apr 2020 11:50:11 -0700 Subject: Minor improvements to the resource descriptions Update things so we spit out better docs. Signed-off-by: Tim Smith --- lib/chef/resource/rpm_package.rb | 2 +- lib/chef/resource/script.rb | 3 ++- lib/chef/resource/service.rb | 2 +- lib/chef/resource/windows_firewall_rule.rb | 1 + 4 files changed, 5 insertions(+), 3 deletions(-) (limited to 'lib') diff --git a/lib/chef/resource/rpm_package.rb b/lib/chef/resource/rpm_package.rb index 76887a079e..b944142dcb 100644 --- a/lib/chef/resource/rpm_package.rb +++ b/lib/chef/resource/rpm_package.rb @@ -25,7 +25,7 @@ class Chef provides :rpm_package - description "Use the rpm_package resource to manage packages for the RPM Package Manager platform." + description "Use the rpm_package resource to manage packages using the RPM Package Manager." property :allow_downgrade, [ true, false ], default: true, desired_state: false diff --git a/lib/chef/resource/script.rb b/lib/chef/resource/script.rb index 88a5621c9f..71c2f754e4 100644 --- a/lib/chef/resource/script.rb +++ b/lib/chef/resource/script.rb @@ -49,8 +49,9 @@ class Chef property :code, String, required: true property :interpreter, String - property :flags, String + property :flags, String, + description: "One or more command line flags that are passed to the interpreter when a command is invoked." end end end diff --git a/lib/chef/resource/service.rb b/lib/chef/resource/service.rb index 25cc84b163..50a7dda437 100644 --- a/lib/chef/resource/service.rb +++ b/lib/chef/resource/service.rb @@ -82,7 +82,7 @@ class Chef # specify overrides for the start_command, stop_command and # restart_command properties. property :init_command, String, - description: "The path to the init script that is associated with the service. Use init_command to prevent the need to specify overrides for the start_command, stop_command, and restart_command properties. When this property is not specified, the #{Chef::Dist::CLIENT} will use the default init command for the service provider being used.", + description: "The path to the init script that is associated with the service. Use init_command to prevent the need to specify overrides for the start_command, stop_command, and restart_command properties. When this property is not specified, the #{Chef::Dist::PRODUCT} will use the default init command for the service provider being used.", desired_state: false # if the service is enabled or not diff --git a/lib/chef/resource/windows_firewall_rule.rb b/lib/chef/resource/windows_firewall_rule.rb index 7bb69a271f..fcba0dc569 100644 --- a/lib/chef/resource/windows_firewall_rule.rb +++ b/lib/chef/resource/windows_firewall_rule.rb @@ -78,6 +78,7 @@ class Chef property :displayname, String, description: "The displayname to assign to the firewall rule.", default: lazy { rule_name }, + default_description: "The rule_name property value.", introduced: "16.0" property :group, String, -- cgit v1.2.1