On Tue, Sep 3, 2013 at 11:47 AM, Lester Caine <[email protected]> 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