summaryrefslogtreecommitdiffstats
path: root/lib/puppet/face/help.rb
diff options
context:
space:
mode:
authornfagerlund <nick.fagerlund@gmail.com>2011-05-18 16:20:05 -0700
committernfagerlund <nick.fagerlund@gmail.com>2011-05-26 10:07:40 -0700
commit30263333cd30e40468d02e5cc77a0253415cf3e2 (patch)
treed7d948edc5dddf71914b7c6821de2388bff8aa7b /lib/puppet/face/help.rb
parent13e473ed3c2dc53772e75bcb9822b725cf9f8a79 (diff)
downloadpuppet-30263333cd30e40468d02e5cc77a0253415cf3e2.tar.gz
puppet-30263333cd30e40468d02e5cc77a0253415cf3e2.tar.xz
puppet-30263333cd30e40468d02e5cc77a0253415cf3e2.zip
(#7561) Complete help text for all faces and actions
Faces help output relies on input from the documentation methods in each of the faces to be documented. This commit calls those methods in each of our faces, with varying levels of detail depending on their complexity.
Diffstat (limited to 'lib/puppet/face/help.rb')
-rw-r--r--lib/puppet/face/help.rb11
1 files changed, 9 insertions, 2 deletions
diff --git a/lib/puppet/face/help.rb b/lib/puppet/face/help.rb
index aef917447..7a382b8c9 100644
--- a/lib/puppet/face/help.rb
+++ b/lib/puppet/face/help.rb
@@ -7,13 +7,20 @@ Puppet::Face.define(:help, '0.0.1') do
copyright "Puppet Labs", 2011
license "Apache 2 license; see COPYING"
- summary "Displays help about puppet subcommands"
+ summary "Display Puppet help."
action(:help) do
summary "Display help about faces and their actions."
+ arguments "[<face>] [<action>]"
+ returns "Short help text for the specified face or action."
+ examples <<-'EOT'
+ Get help for an action:
+
+ $ puppet help
+ EOT
option "--version VERSION" do
- summary "which version of the interface to show help for"
+ summary "The version of the face for which to show help."
end
default