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.
--
PHP Internals - PHP Runtime Development Mailing List
To unsubscribe, visit: http://www.php.net/unsub.php
