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'