Newsgroups: php.internals
Path: news.php.net
Xref: news.php.net php.internals:52294
Mailing-List: contact internals-help@lists.php.net; run by ezmlm
Received-SPF: pass (pb1.pair.com: domain gmail.com designates 209.85.215.42 as permitted sender)
DomainKey-Status: bad
DomainKey-Signature: a=rsa-sha1; c=nofws;
        d=gmail.com; s=gamma;
        h=mime-version:sender:in-reply-to:references:date
         :x-google-sender-auth:message-id:subject:from:to:cc:content-type;
        b=dj7jeGY0nm21GHx/g9Rv4+F2JFTpaqGpYhBWlHOlH/yw1Tj9EeQWHwSrJm6LQuoB14
         L8UVSb+q0dXFeHs/EqVhti89l7k4FEWwE/BNOAeS2n2y0N5uwgmeMZSBhVaT25/cNtDa
         hfiQJjGjqsCoHT8Ita2RxityQxtzxb79xnqW0=
MIME-Version: 1.0
Sender: tyra3l@gmail.com
In-Reply-To: <4DCA82B5.3080401@naenius.com>
References: <BANLkTinO0h7020fs+PLjM0fUmMjQXoTsyw@mail.gmail.com>
	<4DC826B1.4090806@lerdorf.com>
	<BANLkTikpLY+AntSrNi91rzGNZi4FkPrSwA@mail.gmail.com>
	<4DC82A36.8090604@lerdorf.com>
	<BANLkTi=aLVw8KqOV_jb9dBm=XqX6TqTVwA@mail.gmail.com>
	<4DC83401.2090202@sugarcrm.com>
	<BANLkTiniayhZ+8CRQjPFBDLOBu=E7UUv=A@mail.gmail.com>
	<BANLkTimvE1nE+UOv+8hUaPiyfozn3PgU3Q@mail.gmail.com>
	<BANLkTinfEFsiSWOi3RgjZ4-6QeNjRVMwTQ@mail.gmail.com>
	<4DC8D122.3050507@lsces.co.uk>
	<BANLkTim1euVOKXxLc3FdhJAywqnPHDkbwg@mail.gmail.com>
	<BANLkTi=AxkZf_jMUJ0MaRREVX9t33Ex0Zw@mail.gmail.com>
	<4DC8F125.2010503@toolpark.com>
	<BANLkTi=aUL0UNUK9tF9cz8Nsm3z8AB0XQQ@mail.gmail.com>
	<4DC8FB1A.7040206@lerdorf.com>
	<BANLkTin+jWCzDapesBPaYXXfbCeDDS=UtA@mail.gmail.com>
	<4DC98100.6080806@oracle.com>
	<4DC9827B.6080409@lsces.co.uk>
	<BANLkTikAhrUBe7mrCDXu-Q1+YqjggQTUrw@mail.gmail.com>
	<BANLkTinVJ6s41yeWgtd53bJkOFW1mMcfPw@mail.gmail.com>
	<BANLkTinjVsVRGgqKZYBpp8p9JHQMybbqJQ@mail.gmail.com>
	<4DCA82B5.3080401@naenius.com>
Date: Wed, 11 May 2011 14:52:56 +0200
Message-ID: <BANLkTikFGwV_bfZvSxMPeU6L1A6o8yjMyg@mail.gmail.com>
To: Mike van Riel <mike.vanriel@naenius.com>
Cc: internals@lists.php.net
Content-Type: multipart/alternative; boundary=0016e657b16a36356204a2ff8d88
Subject: Re: [PHP-DEV] annotations again
From: info@tyrael.hu (Ferenc Kovacs)

--0016e657b16a36356204a2ff8d88
Content-Type: text/plain; charset=UTF-8

On Wed, May 11, 2011 at 2:36 PM, Mike van Riel <mike.vanriel@naenius.com>wrote:

> On 05/10/2011 10:03 PM, Chad Fulton wrote:
>
>> On Tue, May 10, 2011 at 12:35 PM, guilhermeblanco@gmail.com
>> <guilhermeblanco@gmail.com>  wrote:
>>
>>> Hi all,
>>>
>>> Based on an extensive chat with Matthew, I think we reached some
>>> consensus.
>>> I'll write another RFC related to Annotations in docblocks, then we
>>> can chat until reach some standardization and availability.
>>>
>>> I'll keep the old one for history purposes. It seems that none from
>>> core php devs accepted it, so I'll move it to rejected.
>>> As I told you previously, all I wanted was some good feedback to give
>>> a north and that's what I had.
>>>
>>> As soon as I finish the new RFC, I'll open another thread here for
>>> fine-grain the support and discuss architecture.
>>> I'll keep Stas comments in mind when creating it, so it would help in
>>> discussions. It seems we still have 2 weeks to discuss the new idea
>>> and less than 2 months to get it ready if everyone agreed.
>>>
>> Please first take a look at the current RFC regarding parsing
>> docblocks: https://wiki.php.net/rfc/docblockparser . Even if you want
>> to put up a competing RFC, at least you can use it as a point of
>> reference.
>>
>> Chad
>>
>
> Additionally I would recommend reading the JavaDoc and phpDocumentor rules
> concerning DocBlocks.
> As far as I can see the RFC mentioned above is incomplete with respect to
> the current syntax guidelines for DocBlocks as mentioned in the documents
> above; which is used for quite a bit of projects out there.
>
> I'll keep my eyes open for the new RFC to see if I can contribute some of
> my experiences to the efforts.
> I hope that my experiences building the Static Reflection for DocBlocks in
> DocBlox can prove useful.
>

as phpDocumentor is dead and doesn't support "new" things like namespace and
closures, we should take those into account also.

Tyrael

--0016e657b16a36356204a2ff8d88--