Newsgroups: php.internals
Path: news.php.net
Xref: news.php.net php.internals:68883
Mailing-List: contact internals-help@lists.php.net; run by ezmlm
Received-SPF: pass (pb1.pair.com: domain gmail.com designates 209.85.128.180 as permitted sender)
MIME-Version: 1.0
In-Reply-To: <52259425.9050209@lsces.co.uk>
References: <52243BA6.5040905@sugarcrm.com>
	<CAEZPtU5u+29CxpgDHs6GOoDUU+EWtm-8dr7NL4dufvSq+LZsyw@mail.gmail.com>
	<5224F2EC.2090609@sugarcrm.com>
	<CAF+90c_1XyHP9+-fJUm7uTg_DH_tfa3yZc-wkGThKDxiYY5eFw@mail.gmail.com>
	<52250A97.8050406@sugarcrm.com>
	<CAF+90c8CXPxVuORfivyJ9EVZny6Ywzm_3rOs+q0kUPJ=VjB6Yg@mail.gmail.com>
	<52251149.4080308@sugarcrm.com>
	<522517D5.7020603@lsces.co.uk>
	<80742DA8-3947-4569-8643-4075FF213259@newtekemail.com>
	<52259425.9050209@lsces.co.uk>
Date: Tue, 3 Sep 2013 13:38:13 +0400
Message-ID: <CAOc_q_ypf2Zy8AnVZBM4xOBp0zS7NpqTQRqLsEr-kFRg6dFFFQ@mail.gmail.com>
To: Lester Caine <lester@lsces.co.uk>
Cc: PHP Internals <internals@lists.php.net>
Content-Type: text/plain; charset=UTF-8
Subject: Re: [PHP-DEV] [RFC] Skipping parameters take 2
From: indeyets@gmail.com (Alexey Zakhlestin)

On Tue, Sep 3, 2013 at 11:47 AM, Lester Caine <lester@lsces.co.uk> wrote:
> Robert Williams wrote:
>>
>> PHPDoc doesn't support parameter blocks, which means that IDEs can't offer
>> the same level of assistance with code-completion that they offer for both
>> objects and straight parameters -- another huge downside.
>
>
> PHPDoc's does 'not' not support parameter blocks ... you just document them
> properly in the first place. Switching these to formalised objects
> introduces another level of complexity that detracts from their use rather
> than enhancing it, but again that is more to do with maintaining BC.
> Something that has become a second class citizen nowadays?

PSR-5 (draft) does support them:

https://github.com/phpDocumentor/fig-standards/blob/master/proposed/phpdoc.md#7-describing-hashes


-- 
Alexey Zakhlestin,
http://github.com/indeyets