Newsgroups: php.internals
Path: news.php.net
Xref: news.php.net php.internals:64705
Mailing-List: contact internals-help@lists.php.net; run by ezmlm
Received-SPF: fail (pb1.pair.com: domain rafaeldohms.com.br does not designate 209.85.220.180 as permitted sender)
MIME-Version: 1.0
In-Reply-To: <50EC917C.3070805@sugarcrm.com>
References: <CADqTB_h4eh4mPi89uRps6vZWXjDEhUtcBopL7jmO-UgRuyf19w@mail.gmail.com>
	<50EBDEEE.8070605@sugarcrm.com>
	<CAOfKkdQXh53oxpCQ59R_hcws4Pd=q+O_VMOZ=tS+F2_7qof3RA@mail.gmail.com>
	<50EC6569.6030202@sugarcrm.com>
	<CAEZPtU5gGsr97ZD+ybxgnRj7=X2mtL4+m0qWdYMg1qsgj0+MrA@mail.gmail.com>
	<50EC917C.3070805@sugarcrm.com>
Date: Tue, 8 Jan 2013 22:51:08 +0100
Message-ID: <CAOhuFvZv9ePXkW+6ZDi_w+-Y-PHBLXSXAMdupX0vst8rsQ+L1g@mail.gmail.com>
To: Stas Malyshev <smalyshev@sugarcrm.com>
Cc: Pierre Joye <pierre.php@gmail.com>, Pierrick Charron <pierrick@webstart.fr>, 
	"internals@lists.php.net" <internals@lists.php.net>
Content-Type: multipart/alternative; boundary=089e0129492087e95704d2cdf16c
Subject: Re: [PHP-DEV] [RFC] Reflection annotations reader
From: listas@rafaeldohms.com.br (Rafael Dohms)

--089e0129492087e95704d2cdf16c
Content-Type: text/plain; charset=ISO-8859-1

On Tue, Jan 8, 2013 at 10:37 PM, Stas Malyshev <smalyshev@sugarcrm.com>wrote:

> Hi!
>
> > Everyone I talked to who implemented annotations in docblocks did it
> > as hack because there is no native support. This is not something that
> > belongs to docblocks. It would be nice if you could take a look at the
> > c# doc, there are really good concepts there.
>
> I know why they did it, and we already discussed that stuff in the last
> annotation discussion. What I mean here is that presenting it as if the
> notion of meaningful comments is completely unheard of in PHP and nobody
> expects it is just wrong. Maybe it was so years ago, but it is
> definitely not true now - de-facto meaningful comments *are* the
> standard now, and have a lot of use, and nobody with any experience is
> surprised by them. Regardless of *why* is it so, it is a fact.
>
> Stas,

That still does not make it the right place. Annotations went into docblocks
because it was the only place reflection could provide the needed
information at
runtime. Just because we now treat docblocks as 1st class citizens does not
mean annotations should be there.

Does that mean that annotations should be in docblocks and not in core
for the reason of "we all know docblocks exist". I would seriously expect
at the very least a stronger reason. These were some of the ones i heard
before:

1. The syntax is crap: this is solvable, let's find the right syntax
2. PHP does not need it: i think we have proven the use already, every
major FW has a
implementation of this, there is clearly demand.

So if we are going to get anywhere with this discussion I suggest getting
back to
the original RFC and working on solving the issues instead of discussing
developer folklore.

-- 
Rafael Dohms
PHP Evangelist and Community Leader
http://doh.ms
http://wwwamsterdamphp.nl

--089e0129492087e95704d2cdf16c--