(#6962) Add 'description' to faces and action.

This adds the 'description' method to the faces and actions, as well as
structured testing to ensure that the DSL works as expected.

Reviewed-By: Max Martin <max@puppetlabs.com>

2 files changed, 15 insertions, 3 deletions

diff --git a/lib/puppet/interface.rb b/lib/puppet/interface.rb
index 4a36b509a..d97e462de 100644
--- a/lib/puppet/interface.rb
+++ b/lib/puppet/interface.rb
@@ -68,9 +68,14 @@ class Puppet::Interface
     self.default_format = format.to_sym
   end
 
-  attr_accessor :summary
+  ########################################################################
+  # Documentation.  We currently have to rewrite both getters because we share
+  # the same instance between build-time and the runtime instance.  When that
+  # splits out this should merge into a module that both the action and face
+  # include. --daniel 2011-04-17
+  attr_accessor :summary, :description
   def summary(value = nil)
-    value.nil? or summary = value
+    self.summary = value unless value.nil?
     @summary
   end
   def summary=(value)
@@ -81,6 +86,13 @@ class Puppet::Interface
     @summary = value
   end
 
+  def description(value = nil)
+    self.description = value unless value.nil?
+    @description
+  end
+
+
+  ########################################################################
   attr_reader :name, :version
 
   def initialize(name, version, &block)
diff --git a/lib/puppet/interface/action.rb b/lib/puppet/interface/action.rb
index d2d4facaa..860ce4058 100644
--- a/lib/puppet/interface/action.rb
+++ b/lib/puppet/interface/action.rb
@@ -28,7 +28,7 @@ class Puppet::Interface::Action
 
   ########################################################################
   # Documentation stuff, whee!
-  attr_accessor :summary
+  attr_accessor :summary, :description
   def summary=(value)
     value = value.to_s
     value =~ /\n/ and