Hi!
I think we have the main issue here, it has absolutely nothing to do with users documentation, as phpdoc does. Yes, they both somehow
> 'document' something but still totally unrelated for the goals and > usages. To understand that would help to move forward.
Phpdocs aren't "user documentation" only, not for a long time (I mean the concept, not the particular application called phpDocumentor, of course). They are being used as metadata in many places. You could argue that's misguided but you can't ignore the fact that's what people do. The "goals and usages" of those tags are exactly metadata - and regardless of the annotations, I'd be happy if Reflection recognized it finally (by integrating some kind of phpdoc tag parser).
In general, I don't see why metadata written as /** @data */ is that much worse than metadata written as [data()]. Can you explain?
-- Stanislav Malyshev, Software Architect SugarCRM: http://www.sugarcrm.com/ (408)454-6900 ext. 227 -- PHP Internals - PHP Runtime Development Mailing List To unsubscribe, visit: http://www.php.net/unsub.php
