Jason Voegele wrote:

> I agree that the simple @tags are better than XML style tags.  I'm not
> sure
> the @ symbol is the one we want, though.  Say, for example that your Book
> class has an instance variable named @author that you reference in one of
> your doc-comments.  This could confuse the doc tool.  How 'bout %param?

Doxygen already supports both javadoc style and its own style, i.e.:

@param

and

\param

I agree that @ doesn't make sense for Ruby, but keeping consistent with 
Doxygen might be a good thing.


-- 
The key of strategy... is not to choose a path that leads to victory, but 
to choose so that all paths lead to a victory.
-- L.M. Bujold