[cfe-commits] [PATCH] Lexer for structured comments

[Sebastian Redl]

As a general comment on the path this is taking, it seems like we're building a parser for a specific kind of structured comments right into Clang. (Maybe I'm misunderstanding, in which case you should ignore this mail.) Is this really what we want? Can't we completely outsource all lexing/parsing/AST building for structured comments to something completely separate, like a plugin?

Doxygen and its relations are the most popular format for doc comments out there, but I personally am not at all fond of it. (Or Javadoc, or C# XMLDoc, etc.) I really don't like markup of any kind cluttering up the comments, often making them hard to read without prior processing. I would much prefer a Wiki-style comment format that looks good as unprocessed text too.

So at the very least, I would expect this default parser to not get in the way of completely different approaches.

Sebastian