Newsgroups: php.internals Path: news.php.net Xref: news.php.net php.internals:64625 Return-Path: Mailing-List: contact internals-help@lists.php.net; run by ezmlm Delivered-To: mailing list internals@lists.php.net Received: (qmail 19471 invoked from network); 7 Jan 2013 06:20:45 -0000 Received: from unknown (HELO lists.php.net) (127.0.0.1) by localhost with SMTP; 7 Jan 2013 06:20:45 -0000 Authentication-Results: pb1.pair.com header.from=mike.vanriel@naenius.com; sender-id=pass Authentication-Results: pb1.pair.com smtp.mail=mike.vanriel@naenius.com; spf=pass; sender-id=pass Received-SPF: pass (pb1.pair.com: domain naenius.com designates 83.96.159.14 as permitted sender) X-PHP-List-Original-Sender: mike.vanriel@naenius.com X-Host-Fingerprint: 83.96.159.14 linux35.webawere.nl Received: from [83.96.159.14] ([83.96.159.14:56161] helo=linux35.webawere.nl) by pb1.pair.com (ecelerity 2.1.1.9-wez r(12769M)) with ESMTP id D2/85-12349-A396AE05 for ; Mon, 07 Jan 2013 01:20:42 -0500 Received: from linux24.webawere.nl ([188.122.88.105] helo=webmail.web-oke.nl) by linux35.webawere.nl with esmtpa (Exim 4.80.1) (envelope-from ) id 1Ts64c-0007Zf-Kc; Mon, 07 Jan 2013 07:20:38 +0100 MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8; format=flowed Content-Transfer-Encoding: 7bit Date: Mon, 07 Jan 2013 07:20:38 +0100 To: Yahav Gindi Bar Cc: PHP internals In-Reply-To: References: Message-ID: X-Sender: mike.vanriel@naenius.com User-Agent: Web-Oke Webmail/0.7.1 X-Antivirus-Scanner: Seems clean. You should still use an Antivirus Scanner Subject: Re: [PHP-DEV] [RFC] Reflection annotations reader From: mike.vanriel@naenius.com (Mike van Riel) 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.