Re: docBlock Parser RFC

From: Date: Thu, 16 Sep 2010 21:23:30 +0000
Subject: Re: docBlock Parser RFC
References: 1  Groups: php.internals 
Request: Send a blank email to internals+get-49737@lists.php.net to get a copy of this message
Am 16.09.2010 22:56, schrieb Chad Fulton: > 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 > Hi Chad, the RFC looks for me like a built-in PHPDocumentor parser. This can be useful. The problem for me is that I cannot parse the file level doc block. What is with tags like @Validator('blabla'). I cannot find an example for this scenario. Greetings, Christian

« previous php.internals (#49737) next »