Newsgroups: php.internals
Path: news.php.net
Xref: news.php.net php.internals:49657
Return-Path: <zeev@zend.com>
Mailing-List: contact internals-help@lists.php.net; run by ezmlm
Delivered-To: mailing list internals@lists.php.net
Received: (qmail 55145 invoked from network); 15 Sep 2010 06:56:28 -0000
Received: from unknown (HELO lists.php.net) (127.0.0.1)
  by localhost with SMTP; 15 Sep 2010 06:56:28 -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:55865] helo=il-mr1.zend.com)
	by pb1.pair.com (ecelerity 2.1.1.9-wez r(12769M)) with ESMTP
	id 67/94-33442-A1E609C4 for <internals@lists.php.net>; Wed, 15 Sep 2010 02:56:27 -0400
Received: from il-gw1.zend.com (unknown [10.1.1.21])
	by il-mr1.zend.com (Postfix) with ESMTP id B53D9504F4;
	Wed, 15 Sep 2010 08:54:18 +0200 (IST)
Received: from LAP-ZEEV.zend.com ([10.1.20.36]) by il-gw1.zend.com with Microsoft SMTPSVC(6.0.3790.4675);
	 Wed, 15 Sep 2010 08:56:23 +0200
Message-ID: <7.0.1.0.2.20100915085504.17eab4d8@zend.com>
X-Mailer: QUALCOMM Windows Eudora Version 7.0.1.0
Date: Wed, 15 Sep 2010 08:55:55 +0200
To: Stas Malyshev <smalyshev@sugarcrm.com>
Cc: Pierre Joye <pierre.php@gmail.com>,
 Pierrick Charron <pierrick@webstart.fr>,
 Jonathan Bond-Caron <jbondc@openmv.com>,
 Nate Abele <nate.abele@gmail.com>,
 PHP Development <internals@lists.php.net>
In-Reply-To: <4C906333.4030204@sugarcrm.com>
References: <39505F13-655A-43AF-941E-77750B7F7201@gmail.com>
 <001601cb543a$d81ebac0$885c3040$@com>
 <AANLkTikxw_xHn2fosykSwTat_qsGA16KriFinqc8Btrq@mail.gmail.com>
 <4C8FC695.2060800@sugarcrm.com>
 <AANLkTimOaicMidzH8oYWcieaCyx2bLefPGkXGQDZPQ6Y@mail.gmail.com>
 <4C8FD72B.1070108@sugarcrm.com>
 <AANLkTimEMdn6Z64O0Jt9KYEdHfDRa0iLt5eh1D16i_st@mail.gmail.com>
 <4C906333.4030204@sugarcrm.com>
Mime-Version: 1.0
Content-Type: text/plain; charset="us-ascii"; format=flowed
X-OriginalArrivalTime: 15 Sep 2010 06:56:23.0514 (UTC) FILETIME=[1BED73A0:01CB54A3]
Subject: Re: [PHP-DEV] Re: Re: PHP Annotations RFC + Patch
From: zeev@zend.com (Zeev Suraski)

At 08:09 15/09/2010, Stas Malyshev wrote:
>Phpdocs aren't "user documentation" only, not for a long time (I 
>mean the concept, not the particular application called 
>phpDocumentor, of course). They are being used as metadata in many 
>places. You could argue that's misguided but you can't ignore the 
>fact that's what people do. The "goals and usages" of those tags are 
>exactly metadata - and regardless of the annotations, I'd be happy 
>if Reflection recognized it finally (by integrating some kind of 
>phpdoc tag parser).

I second that word for word.  FWIW, I don't see it as misguided at all.

Zeev