I filed a ticket today relating to PHPdoc @param tags in the symfony
project missing the '$paramname' portion of the tag.
http://trac.symfony-project.com/ticket/2991

Obviously this is not a major priority.  On the other hand, it does
cause some problems with code hinting.

I first wanted to check that people agree that this is something that
in an ideal universe should be fixed.  If I get consensus on that,
then I propose the following steps:

 1. I'll update the documentation on code style to reflect the correct
standard for the comment headers, so that with luck future code can
follow the standard.
 2. When I get a chance (may be quite a way off) I'll investigate some
kind of automated or semi-automated way to make this update (or at
least to locate places where it is needed).
 3. I'll make a branch for this purpose, apply the changes there, and
then make it available for review before merging.

Thoughts?

David Brewer

--~--~---------~--~----~------------~-------~--~----~
You received this message because you are subscribed to the Google Groups 
"symfony developers" group.
To post to this group, send email to [email protected]
To unsubscribe from this group, send email to [EMAIL PROTECTED]
For more options, visit this group at 
http://groups.google.com/group/symfony-devs?hl=en
-~----------~----~----~----~------~----~------~--~---

Reply via email to