On 4/26/12 12:59 PM, Krinkle wrote:
I'm not confinced (yet) that we should migrate to
"@param type $var:
description". Putting the type after the variable works just fine and we've
been
doing it for years, and in at least one case (the second one in the above
summary) the Doxygen parser actually chokes on it for whatever reason.
We definitely shouldn't migrate to "@param type $var: description"
because that's not valid doxygen syntax. The correct syntax is without a
colon. This is why your 2nd example ends up with mangled output. If we
follow the correct syntax, it should output fine. And since we're using
the standard doxygen parser, the only argument I can see for sticking
with the old syntax is because "we've been doing it for years", which
isn't very convincing.
Ryan Kaldari