ronn.rb in shoe-0.6.2

- old
+ new

@@ -12,13 +12,12 @@
     # <tt>authors[http://docs.rubygems.org/read/chapter/20#authors]</tt>
     # in your gemspec, respectively.
     #
     # == Notes
     #
-    # * It's best to check the generated man pages into version control so
-    #   they'll be included in your gem for
-    #   {gem-man}[http://github.com/defunkt/gem-man].
+    # * It's best to include the generated man pages in your gem, so that
+    #   {gem-man}[http://github.com/defunkt/gem-man] can get to them.
     #
     # * Ronn becomes a prerequisite for Release, so your man pages are sure to
     #   be up-to-date.
     #
     # * You may like to add a <tt>task :man => :ronn</tt> to your
@@ -40,10 +39,15 @@
       end
 
       private
 
       def define_tasks
-        desc 'Generate man pages'
+        desc <<-END.gsub(/^ */, '')
+          Generate man pages.
+          Configure via the `date` and `authors` fields in #{spec.name}.gemspec.
+          Uses ronn sources in man/*.ronn.
+        END
+
         task :ronn => 'ronn:build' do
           sh 'man', *man_files
         end
 
         namespace :ronn do