Comments parsing

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