Newsgroups: php.internals
Path: news.php.net
Xref: news.php.net php.internals:64639
Mailing-List: contact internals-help@lists.php.net; run by ezmlm
Received-SPF: pass (pb1.pair.com: domain gmail.com designates 209.85.215.49 as permitted sender)
MIME-Version: 1.0
In-Reply-To: <50EAEECB.7060005@lsces.co.uk>
References: <CANVTSm5XE69i=KkZV621+tmwWbSKnsHECN0UsLin7mdBTc+jOg@mail.gmail.com>
	<ea7b12fcb7a6ef555c9c41bc486a9b0b@naenius.com>
	<50EA8794.4000202@lsces.co.uk>
	<CAEZPtU7c+Eh10T1KVF+6doP9jPCNusg9_wCrERme4Cb4m0Mgdw@mail.gmail.com>
	<50EAEECB.7060005@lsces.co.uk>
Date: Mon, 7 Jan 2013 18:08:59 +0100
Message-ID: <CAEZPtU6uFDzT7bwjhFPURMW5Ww-ROSFN7KTqFC0=GsqEQG1CXQ@mail.gmail.com>
To: Lester Caine <lester@lsces.co.uk>
Cc: PHP internals <internals@lists.php.net>
Content-Type: text/plain; charset=ISO-8859-1
Subject: Re: [PHP-DEV] [RFC] Reflection annotations reader
From: pierre.php@gmail.com (Pierre Joye)

On Mon, Jan 7, 2013 at 4:50 PM, Lester Caine <lester@lsces.co.uk> wrote:
> Pierre Joye wrote:
>>
>> On Mon, Jan 7, 2013 at 9:30 AM, Lester Caine <lester@lsces.co.uk> wrote:
>>>
>>> Mike van Riel wrote:
>>>>
>>>>
>>>>
>>>> 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.
>>>
>>>
>>> This also forms the basis of many of the IDE in-line help material.
>>> Producing something different then requires that all the IDE's are
>>> reworked
>>> as well :(
>>
>>
>> Annotations have nothing to do with user land documentation, please
>> don't go down this discussion again as it will be of no help for this
>> topic.
>
>
> So scrap https://wiki.php.net/rfc/reflection_doccomment_annotations and
> https://wiki.php.net/rfc/annotations-in-docblock as not being a appropriate
> way of handling this then! DocBlocks have a well defined format so hijacking
> them for other purposes as this thread is proposing is what is not helpful?

It is helpful because it is the only way to do it right now, within
comments. And no, docblocks are not annotation either.

In my humble opinion there is only one clean way to implement them, at
compile time, using the parser. Using SPL (kind of "let put everything
in there because the engine is too complicated (implementation or
politics around it)") is not a good idea either.

Cheers,
--
Pierre

@pierrejoye | http://blog.thepimp.net | http://www.libgd.org