Newsgroups: php.internals
Path: news.php.net
Xref: news.php.net php.internals:64787
Return-Path: <mike.vanriel@naenius.com>
Mailing-List: contact internals-help@lists.php.net; run by ezmlm
Delivered-To: mailing list internals@lists.php.net
Received: (qmail 7425 invoked from network); 9 Jan 2013 21:04:21 -0000
Received: from unknown (HELO lists.php.net) (127.0.0.1)
  by localhost with SMTP; 9 Jan 2013 21:04:21 -0000
Authentication-Results: pb1.pair.com header.from=mike.vanriel@naenius.com; sender-id=pass
Authentication-Results: pb1.pair.com smtp.mail=mike.vanriel@naenius.com; spf=pass; sender-id=pass
Received-SPF: pass (pb1.pair.com: domain naenius.com designates 83.96.159.14 as permitted sender)
X-PHP-List-Original-Sender: mike.vanriel@naenius.com
X-Host-Fingerprint: 83.96.159.14 linux35.webawere.nl  
Received: from [83.96.159.14] ([83.96.159.14:53030] helo=linux35.webawere.nl)
	by pb1.pair.com (ecelerity 2.1.1.9-wez r(12769M)) with ESMTP
	id 02/1A-02684-35BDDE05 for <internals@lists.php.net>; Wed, 09 Jan 2013 16:04:20 -0500
Received: from linux24.webawere.nl ([188.122.88.105] helo=webmail.web-oke.nl)
	by linux35.webawere.nl with esmtpa (Exim 4.80.1)
	(envelope-from <mike.vanriel@naenius.com>)
	id 1Tt2oj-0004v8-IZ; Wed, 09 Jan 2013 22:04:09 +0100
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8;
 format=flowed
Content-Transfer-Encoding: 7bit
Date: Wed, 09 Jan 2013 22:04:09 +0100
To: Derick Rethans <derick@php.net>
Cc: Yahav Gindi Bar <g.b.yahav@gmail.com>, Pierrick Charron
 <pierrick@webstart.fr>, Stas Malyshev <smalyshev@sugarcrm.com>, Rasmus
 Schultz <rasmus@mindplay.dk>, <internals@lists.php.net>
In-Reply-To: <alpine.DEB.2.02.1301091210030.28951@whisky.home.derickrethans.nl>
References: <CADqTB_h4eh4mPi89uRps6vZWXjDEhUtcBopL7jmO-UgRuyf19w@mail.gmail.com>
 <50EBDEEE.8070605@sugarcrm.com>
 <CAOfKkdQXh53oxpCQ59R_hcws4Pd=q+O_VMOZ=tS+F2_7qof3RA@mail.gmail.com>
 <CANVTSm7D8RQWB80o5GD3MCZNKn6DPwfOH-ydYy7ksW2syZpyTg@mail.gmail.com>
 <7710f59e26e95f23a7f6aff8892b881a@naenius.com>
 <alpine.DEB.2.02.1301091210030.28951@whisky.home.derickrethans.nl>
Message-ID: <03d7d0d3ef3bc2cb1798dcd605eebe69@naenius.com>
X-Sender: mike.vanriel@naenius.com
User-Agent: Web-Oke Webmail/0.7.1
X-Antivirus-Scanner: Seems clean.  You should still use an Antivirus Scanner
Subject: Re: [PHP-DEV] Docblocks vs Annotations (Was: Re: [PHP-DEV] [RFC]
 Reflection annotations reader)
From: mike.vanriel@naenius.com (Mike van Riel)

On 09.01.2013 13:12, Derick Rethans wrote:
> There is a tokenizer for this already that Greg wrote ages ago in 
> pecl:
> http://pecl.php.net/package/docblock - why can't that be extended to
> parse your style of annotations in docblocks?

To be honest; I haven't had the time yet to learn and apply extension
programming and work / expand on that. I would love for an extension to
come to life or even a core module so that we can all standardize on 
it.

As far as I am concerned I am not advocating my personal way or that of
phpDocumentor but of the PHPDoc standard which is above that.

And as a last note to this mail I would like to add that annotations 
are
not part of PHPDoc. The draft that I have written will allow for the
annotation syntax (current PHPDoc does not) but actual handling of
annotations will always be out of scope as far as I am concerned.