[PHP-DEV] docBlock Parser RFC

2010-09-16 Thread 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 s

Re: [PHP-DEV] docBlock Parser RFC

2010-09-16 Thread Christian Kaps
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

Re: [PHP-DEV] docBlock Parser RFC

2010-09-16 Thread Pierre Joye
hi, That's nice a nice idea. The PHPDocumentator guys did something to help the parsing via a pecl's extension (http://pecl.php.net/docblock). Now, to implement the docbloc parsing itself will require a parser usage (lemon or whatever else you want), it will be freaking tricky, not necessary fast

Re: [PHP-DEV] docBlock Parser RFC

2010-09-16 Thread Gustavo Lopes
On Thu, 16 Sep 2010 21:56:04 +0100, Chad Fulton 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 e

Re: [PHP-DEV] docBlock Parser RFC

2010-09-16 Thread Chad Fulton
Hello, Yes, this is not an RFC for annotations or to replicate the exact functionality you wanted within doc comments. However, there is support based on the annotations thread for "APIs to parse doc blocks". I don't know what is meant by others (Zeev, Stas, etc) when they say this. However, in w

Re: [PHP-DEV] docBlock Parser RFC

2010-09-16 Thread Chad Fulton
Hello! That is a good point, there would be no file-level doc block in the RFC. Here is my reasoning for not including it in the RFC: Since the motivation for this came from the desire for metadata for PHP structures, it seemed inappropriate to include metadata at the file level (since it's not a

Re: [PHP-DEV] docBlock Parser RFC

2010-09-17 Thread Ferenc Kovacs
On Thu, Sep 16, 2010 at 10:56 PM, Chad Fulton wrote: > 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 th

Re: [PHP-DEV] docBlock Parser RFC

2010-09-17 Thread Mike van Riel
On Thu, 2010-09-16 at 13:56 -0700, Chad Fulton wrote: > 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 t

Re: [PHP-DEV] docBlock Parser RFC

2010-09-17 Thread Matthew Weier O'Phinney
On 2010-09-16, "Gustavo Lopes" wrote: > On Thu, 16 Sep 2010 21:56:04 +0100, Chad Fulton > 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 on

Re: [PHP-DEV] docBlock Parser RFC

2010-09-17 Thread Gustavo Lopes
On Fri, 17 Sep 2010 13:41:33 +0100, Matthew Weier O'Phinney wrote: On 2010-09-16, "Gustavo Lopes" wrote: 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. Let's argue this one on its own meri

RE: [PHP-DEV] docBlock Parser RFC

2010-09-17 Thread James Butler
FWIW, I am in favour of something that allows the parsing of DocBlock comments (should it just be DocBlock comments though?) and am implementation agnostic so far (i have too little understanding of where in the core/extensions this would need to sit). This would then allow developers to hack o