As an experiment, the latest CVS RDoc from ruby-lang now supports
documentation in =begin/=end blocks. In order to distinguish them from
existing RD comments, RDoc insists that you add a ‘rdoc’ label to the
=begin:
=begin rdoc
This is
my documentation
=end
I’m considering this an experimental change, as I’m not sure I’ve
thought through all the ramifications.
Cheers
Dave