Newsgroups: php.internals
Path: news.php.net
Xref: news.php.net php.internals:78685
Mailing-List: contact internals-help@lists.php.net; run by ezmlm
Received-SPF: pass (pb1.pair.com: domain gmail.com designates 209.85.223.193 as permitted sender)
MIME-Version: 1.0
In-Reply-To: <5459411E.9040106@lsces.co.uk>
References: <CALW=WECCELQOZpqB3foM6T+Qz+0v3hWT-mdTgCmGApEG4vxNcg@mail.gmail.com>
	<CAGAGxbZfDd5QaQ5iW+_pJzcHDHQztG_H_9JVyv4XT4BDaLVczw@mail.gmail.com>
	<CADUqk8UNnSL7C5_RDoNNFsdpuBoAFwdmzanaF9+GkeLN_gQkhQ@mail.gmail.com>
	<CAEZPtU44YsM1s_zJqPhAEu6cbqxh4k=A35qOd_z=XWErNf5wPA@mail.gmail.com>
	<5457AF2F.90808@php.net>
	<5457BDB7.8070701@garfieldtech.com>
	<CAFMT4NrgLzzpMt5Vm_Q84hXJ65U2jjqtLFm=ALYqwtiyxp0LjA@mail.gmail.com>
	<CAEZPtU4urLHc9FM0GohQJwkZD-TYKTVuPXcUMXsG5cAScHz3mw@mail.gmail.com>
	<54589A8D.3020607@sugarcrm.com>
	<CAEZPtU5qfcjCrcWRKW+ETF4uBp46rwVbv9nCdJoSUF+M+wKQdA@mail.gmail.com>
	<CAEPJdumXG9TC7xG8-YmGbQiwPMzwYvE_jXWvOQuNmz+U_=+ZaQ@mail.gmail.com>
	<1C3F4FA3-ABD5-4F6F-A898-F63AC1C723D5@ajf.me>
	<54591A76.8070302@sugarcrm.com>
	<967E30E5-71CB-40F8-9AE2-733D327DE197@ajf.me>
	<CAFp73XtxhW6t0k5TMa5n1ErC_7vur55Sa9oLtUM1P+X1Wugemg@mail.gmail.com>
	<5459411E.9040106@lsces.co.uk>
Date: Tue, 4 Nov 2014 22:24:50 +0100
Message-ID: <CAOjCV8zN-jW0X_nu2BWUo58M_LPPWfxEOXSjKYoNPPWGC41SBA@mail.gmail.com>
To: Lester Caine <lester@lsces.co.uk>
Cc: internals@lists.php.net
Content-Type: text/plain; charset=UTF-8
Subject: Re: [PHP-DEV] Annotation PHP 7
From: sbj.ml.read@gmail.com ("Sebastian B.-Hagensen")

Just as a note: /** and /* are already treated differently by the
parser (T_DOC_COMMENT vs. T_COMMENT, this difference is also present
in opcache).

Anyway, metadata/annotations/whatever you want to call them should be
seperated from comments and verbal descriptions on a
syntax level, not just by some conventions. It's one of the big
advantages of having them in the core. If your project needs to
support php5 you can still use doc-comments to store such data, even
if php7 gets first class annotations you may still parse the comment
in whichever way you want. By having a native way of defining them,
php would also avoid all possiblities of bc-breaks in libraries
consuming doc-comments.

2014-11-04 22:11 GMT+01:00 Lester Caine <lester@lsces.co.uk>:
> On 04/11/14 20:18, guilhermeblanco@gmail.com wrote:
>> Primarily, I do not see docblocks as the right place to store class'
>> metadata information. Metadata != Comments.
>
> We use comment wrappers in many places to hide secondary material from
> other processes. Just rename docblocks -> metadata ... what is the
> problem? Now expand the docblock key words and one does not have to
> worry about clashes as it's all ring fenced.
>
> Is the material needed at runtime? In which case 'minimize' can strip it
> all. I can even see a case for /** being treated differently to /* and
> // blocks if needs be.
>
> --
> Lester Caine - G8HFL
> -----------------------------
> Contact - http://lsces.co.uk/wiki/?page=contact
> L.S.Caine Electronic Services - http://lsces.co.uk
> EnquirySolve - http://enquirysolve.com/
> Model Engineers Digital Workshop - http://medw.co.uk
> Rainbow Digital Media - http://rainbowdigitalmedia.co.uk
>
> --
> PHP Internals - PHP Runtime Development Mailing List
> To unsubscribe, visit: http://www.php.net/unsub.php
>