docBlock Parser RFC
| From: | Chad Fulton | Date: | Thu, 16 Sep 2010 20:56:04 +0000 |
| Subject: | docBlock Parser RFC | ||
| Groups: | php.internals | ||
| Request: | Send a blank email to internals+get-49734@lists.php.net to get a copy of this message | ||
Hello,
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.
The RFC was meant to conform to existing convention on the formatting
of docBlocks - so one major way to improve it would be to note any
inconsistencies with accepted practice.
Feel free to improve in any other way as well, of course.
Thanks,
Chad