Fix sections not displaying their text

There were a few things wrong that made this not work:
* Formatting expects `@comment` but there is only `@comments`
* The parse method used for marshaling overwrote the markdown parse method
* `@store` was not present, which the formatter requires

Author: Earlopain

lib/rdoc/code_object/context.rb

@@ -587,7 +587,7 @@ def add_section(title, comment = nil)
     if section = @sections[title] then
       section.add_comment comment if comment
     else
-      section = Section.new self, title, comment
+      section = Section.new self, title, comment, @store
       @sections[title] = section
     end
 

lib/rdoc/code_object/context/section.rb

@@ -17,11 +17,6 @@ class RDoc::Context::Section
 
   MARSHAL_VERSION = 0 # :nodoc:
 
-  ##
-  # Section comment
-
-  attr_reader :comment
-
   ##
   # Section comments
 
@@ -37,12 +32,18 @@ class RDoc::Context::Section
 
   attr_reader :title
 
+  ##
+  # The RDoc::Store for this object.
+
+  attr_reader :store
+
   ##
   # Creates a new section with +title+ and +comment+
 
-  def initialize(parent, title, comment)
+  def initialize(parent, title, comment, store = nil)
     @parent = parent
     @title = title ? title.strip : title
+    @store = store
 
     @comments = []
 
@@ -151,7 +152,7 @@ def marshal_dump
     [
       MARSHAL_VERSION,
       @title,
-      parse,
+      to_document,
     ]
   end
 
@@ -169,7 +170,7 @@ def marshal_load(array)
   # Parses +comment_location+ into an RDoc::Markup::Document composed of
   # multiple RDoc::Markup::Documents with their file set.
 
-  def parse
+  def to_document
     RDoc::Markup::Document.new(*@comments.map(&:parse))
   end
 
@@ -182,6 +183,23 @@ def plain_html
     @title || 'Top Section'
   end
 
+  ##
+  # Section comment
+
+  def comment
+    return nil if @comments.empty?
+    RDoc::Comment.from_document(to_document)
+  end
+
+  def description
+    return '' if @comments.empty?
+    markup comment
+  end
+
+  def language
+    @comments.first&.language
+  end
+
   ##
   # Removes a comment from this section if it is from the same file as
   # +comment+

test/rdoc/rdoc_context_section_test.rb

@@ -40,6 +40,25 @@ def test_add_comment
     assert_equal [c2, c3], s.comments
   end
 
+  def test_description
+    file1 = @store.add_file 'file1.rb'
+    klass = file1.add_class RDoc::NormalClass, 'Klass'
+
+
+    c1 = comment "# :section: section\n", file1, :ruby
+    c2 = comment "# hello\n",             file1, :ruby
+    c3 = comment "# <tt>world</tt>\n",    file1, :ruby
+
+    s = @S.new klass, 'section', c1, @store
+    assert_equal '', s.description
+
+    s.add_comment c2
+    assert_equal "\n<p>hello</p>\n", s.description
+
+    s.add_comment c3
+    assert_equal "\n<p>hello</p>\n\n<p><code>world</code></p>\n", s.description
+  end
+
   def test_aref
     assert_equal 'section', @s.aref
 
@@ -86,7 +105,7 @@ def test_marshal_dump
     expected = doc RDoc::Comment.new('comment', @top_level).parse
 
     assert_equal 'section', loaded.title
-    assert_equal expected,  loaded.parse
+    assert_equal expected,  loaded.to_document
     assert_nil              loaded.parent, 'parent is set manually'
   end
 
@@ -112,7 +131,7 @@ def test_marshal_load_version_0
     expected = doc RDoc::Comment.new('comment', @top_level).parse
 
     assert_equal 'section', loaded.title
-    assert_equal expected,  loaded.parse
+    assert_equal expected,  loaded.to_document
     assert_nil              loaded.parent, 'parent is set manually'
   end
 
@@ -139,7 +158,7 @@ def test_remove_comment_document
 
     loaded.remove_comment comment('bogus', @top_level)
 
-    assert_equal doc(other_comment.parse), loaded.parse
+    assert_equal doc(other_comment.parse), loaded.to_document
   end
 
 end