doc comments

[flosse]

at the moment we have single line and block comments but I'd like to add support for doc comments too. e.g.: for java:

// line comment
/** doc comment */
/* block comment */

or rust:

// line comment
/// doc comment

what do you think?

[jmatsushita]

That sounds like a good idea. Also I arrived here as I was wondering about another form of documentation which is markdown files. What do you think?