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