On 2010-09-16, "Gustavo Lopes" <glo...@nebm.ist.utl.pt> wrote: > On Thu, 16 Sep 2010 21:56:04 +0100, Chad Fulton <chadful...@gmail.com> > wrote: > > > Based on comments from the annotations thread, I have created a > > docBlock parser RFC at http://wiki.php.net/rfc/docblockparser > > > > This RFC does not deal with annotations per se, but only with the idea > > of adding a function to the Reflection extension which would parse > > docBlocks according to a set docBlock syntax into a simple associative > > array containing three elements: short description, long description, > > and an array of tags. > > > > This is only meant to aid meta-data retrieval for classes and does not > > automatically instantiate anything objects. > > Pointless. > > Well, this will maybe speedup and standardize the usage of doc comments, > but it's very far from what we could do with real annotations.
I understand that you're coming from the point of view of annotations. However, that does not make this proposal "pointless." There are many uses for it: it would greatly speed-up and facilitate API documentation generators; it could be used in a number of projects that scan docblock annotations in order to get parameter and return value typehinting (we use this in ZF for the various server classes), and more. Let's argue this one on its own merits, and not on the basis of whether or not it can be used for annotations parsing; that can and should be a separate, later issue. -- Matthew Weier O'Phinney Project Lead | matt...@zend.com Zend Framework | http://framework.zend.com/ PGP key: http://framework.zend.com/zf-matthew-pgp-key.asc -- PHP Internals - PHP Runtime Development Mailing List To unsubscribe, visit: http://www.php.net/unsub.php
