Newsgroups: php.internals
Path: news.php.net
Xref: news.php.net php.internals:92859
Mailing-List: contact internals-help@lists.php.net; run by ezmlm
Received-SPF: pass (pb1.pair.com: domain gmail.com designates 209.85.215.43 as permitted sender)
MIME-Version: 1.0
In-Reply-To: <CADyq6s+P5p-xdJ8CQaFo3Nrwe7ooyCLg1p=98E0kcSscBbSe8A@mail.gmail.com>
References: <BY2PR0201MB178479B3AF8BD49583233034BF6E0@BY2PR0201MB1784.namprd02.prod.outlook.com>
	<CAFKaYMqg6H2YAgS-ATjcYtXw8GLbp_Kr+VuZFMRPZTkAS1g0hA@mail.gmail.com>
	<571965D1.9020102@zend.com>
	<CAFp73Xs=-sK4ZM-mM8Jp5wWkpYLuen+-K0R9xfZaumBM_sPPFw@mail.gmail.com>
	<5719CDB2.90103@zend.com>
	<CAFp73XtqBtLdoTykrg_1eeJZTFszcmutNpynmyGKEizPiC2Juw@mail.gmail.com>
	<571DCA6A.2070803@zend.com>
	<CAFp73XsVJ=1QxvwLbqvDw8o3BD6Ly7BjrP5X+68O=z6iH-brWA@mail.gmail.com>
	<571E35D8.8080504@zend.com>
	<571E4A83.3080304@garfieldtech.com>
	<571E64A2.2040505@gmail.com>
	<CADqTB_hH4=Rx2ZV_WSJuCPzbnA-ERyFUE8ZsCew2Z6p0+FHWsg@mail.gmail.com>
	<5720A6B4.4000307@lsces.co.uk>
	<CADyq6sKBV0n+xnVhRxsP5RDf0oRLMnNO-BM1VEudRgcK1s199A@mail.gmail.com>
	<CADyq6s+P5p-xdJ8CQaFo3Nrwe7ooyCLg1p=98E0kcSscBbSe8A@mail.gmail.com>
Date: Thu, 28 Apr 2016 07:35:56 +0200
Message-ID: <CADyq6sJp-krEpGgat7hWm2YpvtfwAfK1ya0as4Tv2qtCSeNgAw@mail.gmail.com>
To: Lester Caine <lester@lsces.co.uk>
Cc: PHP Internals List <internals@lists.php.net>
Content-Type: multipart/alternative; boundary=001a114014c09c1c9c053184e651
Subject: Re: [PHP-DEV] PHP Attributes -> docBloc alternatives ...
From: ocramius@gmail.com (Marco Pivetta)

--001a114014c09c1c9c053184e651
Content-Type: text/plain; charset=UTF-8

Hey Lester,

This is what Mike van Riel was working on with PSR-5. Work has been
suspended atm, but I'd still go look at that first.
On Apr 27, 2016 13:47, "Lester Caine" <lester@lsces.co.uk> wrote:

On 25/04/16 20:24, Rasmus Schultz wrote:
> Check here to see what we did for php-annotations:
>
>
https://github.com/php-annotations/php-annotations/blob/master/docs/CustomAnnotations.rst#usageannotation
>
> It's somewhat similar to how C# does it, and it has worked quite nicely.

After some fun caused by the way projects keep getting rewritten to
comply with the latest undemocratic changes to coding style, I have a
copy of php-annotations working without composer and what is imediatly
obvious is that current PHPDoc standard could do with an update.

php-annotations has some nice extensions such as range and length, but
these have been culled from the current builds because they are not part
of the standard. The problem is of cause that phpdoc.org are now
defining that standard and applying their view of how code should be
written, and the tags no longer align with much of the legacy code,
which is why we still have the phpDocumentor1 versions being used.

docBloc annotation IS well established, but can we at least document a
core PHP view of what should be available, and how to extend that to
support the alternat tags people are looking for.

--
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

--001a114014c09c1c9c053184e651--