Hello to everyone.
I just found out a strange issue with rdoc and I’m not sure whether
something wrong in my system (gentoo linux) or with rdoc itself. The
is that rdoc doesn’t consider documentation in block comments
comments) anymore. For example, take a file with the following contents:
Doc for X
Doc for Y
Doc for Z
If I run it through rdoc (using the rdoc gem version 2.5.11 and ruby
it tells me that I have 1 undocumented module, 1 undocumented class and
undocumented method. Accordingly, the generated html files don’t contain
description for X, Y and z. If I replace the block comments with
comments, then everything works correctly.
I am sure that block comments used to work with rdoc at least until
January this year. After that, I started using YARD as documentation
and didn’t try rdoc anymore until yesterday.
Can anybody reproduce this behaviour? Is this a known issue (I couldn’t
anything neither using google nor on the RDoc project page), or a
change in rdoc (I couldn’t find mention of it in the rdoc History.txt
however)? Should I report it as a bug?
Thanks in advance