Hi,
On Wed, Apr 25, 2012 at 05:25:16PM -0700, Ryan Kaldari wrote:
I would support moving to the correct syntax though,
as we shouldn't
keep using the wrong one forever.
I'd also love to be able to use the doxygen suggested syntax.
Then Doxygen's generated HTML output would nicely align not only
parameter type, and parameter name (as we currently have), but also
the parameter description itself.
The HTML output would finally also match the order used for PHP type
hinting.
Besides it would make life easier for devs using IDEs, as some IDEs
support doxygen's order.
Plus new hires are going to use the
up-to-date syntax anyway (until we train them not too).
Been there. Fell into this trap as well :(
Kind regards,
Christian
--
---- quelltextlich e.U. ---- \\ ---- Christian Aistleitner ----
Companies' registry: 360296y in Linz
Christian Aistleitner
Gruendbergstrasze 65a Email: christian(a)quelltextlich.at
4040 Linz, Austria Phone: +43 732 / 26 95 63
Fax: +43 732 / 26 95 63
Homepage:
http://quelltextlich.at/
---------------------------------------------------------------