[cfe-dev] Comments parsing

[Guilherme via cfe-dev]

Hello,

I have noticed that @ref uses the VerbatimLineCommand to parse
everything until the endo of line as the argument to ref.

This does not match the behaviour of doxygen. In doxygen another @ref
command will stop the current command.

I noticed that many commands have a syntax different then the commands
in doxygen. Was this done on purpose? Is there any documentation on
why a specific behaviour was chosen?

Examples:
command | doxygen | clang
----------------------------------------
\ref | <name> ["(text)"] | (name)
\related | <name> | (name)
\relatedalso | <name> | (name)
\ingroup | (<groupname> [<groupname> <groupname>]) | (rest of line)

Cheers
Gui