Newsgroups: php.internals Path: news.php.net Xref: news.php.net php.internals:49613 Return-Path: Mailing-List: contact internals-help@lists.php.net; run by ezmlm Delivered-To: mailing list internals@lists.php.net Received: (qmail 67778 invoked from network); 13 Sep 2010 13:06:03 -0000 Received: from unknown (HELO lists.php.net) (127.0.0.1) by localhost with SMTP; 13 Sep 2010 13:06:03 -0000 Authentication-Results: pb1.pair.com header.from=zeev@zend.com; sender-id=pass Authentication-Results: pb1.pair.com smtp.mail=zeev@zend.com; spf=pass; sender-id=pass Received-SPF: pass (pb1.pair.com: domain zend.com designates 212.25.124.185 as permitted sender) X-PHP-List-Original-Sender: zeev@zend.com X-Host-Fingerprint: 212.25.124.185 il-mr1.zend.com Received: from [212.25.124.185] ([212.25.124.185:42659] helo=il-mr1.zend.com) by pb1.pair.com (ecelerity 2.1.1.9-wez r(12769M)) with ESMTP id 7F/91-57839-8B12E8C4 for ; Mon, 13 Sep 2010 09:06:02 -0400 Received: from il-gw1.zend.com (unknown [10.1.1.21]) by il-mr1.zend.com (Postfix) with ESMTP id 48C7E504BB; Mon, 13 Sep 2010 15:03:58 +0200 (IST) Received: from LAP-ZEEV.zend.com ([10.1.2.16]) by il-gw1.zend.com with Microsoft SMTPSVC(6.0.3790.4675); Mon, 13 Sep 2010 15:05:57 +0200 Message-ID: <7.0.1.0.2.20100913145703.0d226d90@zend.com> X-Mailer: QUALCOMM Windows Eudora Version 7.0.1.0 Date: Mon, 13 Sep 2010 15:05:57 +0200 To: Pierre Joye Cc: Stas Malyshev , Guilherme Blanco , Christian Kaps , Pierrick Charron , "internals@lists.php.net" In-Reply-To: References: <4C873C0F.1010200@zend.com> <4C879613.7090709@zend.com> <4C887D2B.2000605@zend.com> <4C8AC526.7000505@sugarcrm.com> <4C8B6168.30504@mohiva.com> <4C8BC81E.8000605@sugarcrm.com> Mime-Version: 1.0 Content-Type: text/plain; charset="us-ascii"; format=flowed X-OriginalArrivalTime: 13 Sep 2010 13:05:57.0588 (UTC) FILETIME=[67E12140:01CB5344] Subject: Re: [PHP-DEV] Re: PHP Annotations RFC + Patch From: zeev@zend.com (Zeev Suraski) At 20:24 11/09/2010, Pierre Joye wrote: >On Sat, Sep 11, 2010 at 8:19 PM, Stas Malyshev wrote: > > Hi! > > > >> The separator never was a problem... but I definately don't want to > >> see another 6 months just to define what would the separator be. > >> If we need to drop [] in favor of array support, I vote for ! as > >> separator. > > > > The separator is not a problem (even though 1-char one produces much less > > clutter). The cryptic syntax is. > >It seems that there is a misunderstanding about the goals of the >annotations. They are not meant to be read by human being >(javadoc/phpdoc/etc. are) but to be parsed automatically to be used >for services. > >In that sense, to have a syntax closed to one of the best (or less >worst, if you are on the opposed side ;-) syntax out there (c#/.net) >may be a good thing to do, instead of re einventing the php wheel. I'm not sure we've seen a good reason to add annotations instead of using PHPDoc. Sure, PHPDoc isn't a perfect fit for certain purposes, but I think it certainly falls in the good-enough fit for most purposes. It's also both machine and human readable, and best of all - it's already there. There should be overwhelmingly strong reasons to add a whole new branch of syntax to PHP, I for one don't see the huge gain annotations bring on top of PHPDoc. Zeev