On 27 April 2012 02:16, Ryan Kaldari <rkald...@wikimedia.org> wrote: > 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.
This gives me headache: @param $title Title Title for the method There is no separation between the type and description, which makes it hard to read and want to use the type as part of the description So +1 for: @param Title $title Title for the method. -Niklas _______________________________________________ Wikitech-l mailing list Wikitech-l@lists.wikimedia.org https://lists.wikimedia.org/mailman/listinfo/wikitech-l
