Re: [RFC] Reflection annotations reader

From: Date: Mon, 07 Jan 2013 06:20:38 +0000
Subject: Re: [RFC] Reflection annotations reader
References: 1  Groups: php.internals 
Request: Send a blank email to internals+get-64625@lists.php.net to get a copy of this message
Dear Yahav, At phpDocumentor we have been working on formalizing the PHPDoc Standard for quite some time now and I would ask you to take a look at that and use it as basis for the parsing of DocBlocks. You can find the document here: https://github.com/phpDocumentor/phpDocumentor2/blob/develop/docs/PSR.md This document contains an ABNF of a PHPDoc including descriptions and tags as currently used by conventional and modern applications. Do note that annotations are explicitly not detailed in this spec; just their global syntax. This is because the PHPDoc Standard is agnostic to these constructs. This document is still an unfinished draft and open for scrutiny by the community and stakeholders. It documents the current state of affairs and also opens up discussion for future improvements such as Inline DocBlocks. Please let me know if you have any questions, Mike van Riel Lead Developer of phpDocumentor On 06.01.2013 22:58, Yahav Gindi Bar wrote:
Hi internals! In one of the discussions (about the "deprecated" keyword, to be specific), it was been said that adding ability to read doc-comment annotation could be handy. Personally, I really think it can be great. So, I've created an RFC that propose to improve the Reflection extension by adding the ability to read annotations decorated in the doc-comment. https://wiki.php.net/rfc/reflection_doccomment_annotations What is your opinion about this? Regards, Yahav.


« previous php.internals (#64625) next »