Fix display of section comments

lib/rdoc/generator/template/rails/_context.rhtml

@@ -52,7 +52,7 @@
       </div>
     <% end %>
 
-    <%= description_for section %>
+    <%= comments_for @context, section %>
 
     <!-- Constants -->
     <% unless constants.empty? %>

lib/sdoc/helpers.rb

@@ -64,6 +64,12 @@ def description_for(rdoc_object)
     end
   end
 
+  def comments_for(context, section)
+    return if section.comments.empty?
+
+    %(<div class="description">#{context.markup section.comments}</div>)
+  end
+
   def base_tag_for_context(context)
     relative_root = "../" * context.path.count("/")
     %(<base href="./#{relative_root}" data-current-path="#{context.path}">)

lib/sdoc/rdoc_monkey_patches.rb

@@ -32,7 +32,7 @@ def params
 
 
 RDoc::Markup::ToHtmlCrossref.prepend(Module.new do
-  def cross_reference(name, text = nil, code = true)
+  def cross_reference(name, text = nil, code = true, rdoc_ref: false)
     if text
       # Style ref links that look like code, such as `{Rails}[rdoc-ref:Rails]`.
       code ||= !text.include?(" ") || text.match?(/\S\(/)

spec/helpers_spec.rb

@@ -300,6 +300,39 @@ module Foo; end
     end
   end
 
+  describe "#comments_for" do
+    it "returns RDoc::Context::Section#comments wrapped in div.description" do
+      rdoc_module = rdoc_top_level_for(<<~RUBY).find_module_named("Foo")
+        module Foo
+          # :section: Section 1
+          # First comment for Section 1 in +Foo+.
+
+          # :section: Section 1
+          # Second comment for Section 1 in +Foo+.
+        end
+      RUBY
+
+      _(@helpers.comments_for(rdoc_module, rdoc_module.sections.last)).
+        must_equal <<~HTML.chomp
+          <div class="description">
+          <p>First comment for Section 1 in <code>Foo</code>.</p>
+
+          <p>Second comment for Section 1 in <code>Foo</code>.</p>
+          </div>
+        HTML
+    end
+
+    it "returns nil when RDoc::CodeObject#description is empty" do
+      rdoc_module = rdoc_top_level_for(<<~RUBY).find_module_named("Foo")
+        module Foo
+          # :section: One
+        end
+      RUBY
+
+      _(@helpers.comments_for(rdoc_module, rdoc_module.sections.last)).must_be_nil
+    end
+  end
+
   describe "#base_tag_for_context" do
     it "returns a <base> tag with an appropriate path for the given RDoc::Context" do
       top_level = rdoc_top_level_for <<~RUBY