I'm trying sections for the first time, using the latest stable snapshot:

   ruby 1.8.2 (2004-12-06) [i686-linux]

Here's my sections.rb file:

class Foo

   # :section: first

   def first_method
   end

   # :section: second

   def second_method
   end

end


And here's the output:

RDoc failure in section.rb at or around line 5 column 0

Before reporting this, could you check that the file
you're documenting compiles cleanly--RDoc is not a
full Ruby parser, and gets confused easily if fed
invalid programs.

The internal error was:

/usr/local/lib/ruby/1.8/rdoc/parsers/parse_rb.rb:2314:in 
`look_for_directives_in': undefined method `clear' for "# :section: 
first\n":String (NoMethodError)
         from /usr/local/lib/ruby/1.8/rdoc/parsers/parse_rb.rb:2287:in 
`handle'
         from 
/usr/local/lib/ruby/1.8/rdoc/markup/simple_markup/preprocess.rb:21:in 
`gsub!'
         from 
/usr/local/lib/ruby/1.8/rdoc/markup/simple_markup/preprocess.rb:21:in 
`handle'