Re: [RFC] Skipping parameters take 2

From: Date: Tue, 03 Sep 2013 10:37:14 +0000
Subject: Re: [RFC] Skipping parameters take 2
References: 1 2 3 4 5 6 7 8 9 10 11  Groups: php.internals 
Request: Send a blank email to [email protected] to get a copy of this message 
Alexey Zakhlestin 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


Interesting ... pity the current phpdocumentor versions can't support our 'legacy' style of working :( I'm still stuck with 1.4.2 to create http://lsces.org.uk/bitweaverdocsPHP/fisheye/FisheyeGallery.html

-- 
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

Thread (69 messages)

« previous php.internals (#68884) next »