Having been using 'docblock' elements to document classes in PHP for many years,
their use by PHPEclipse and PDE to provide type-hinting and via phpdocumentor to
build developer documentation for classes, I simply haven't seen any need for
some of the more recent developments.
Reflection/Annotations are just another way of 'documenting' classes - aren't
they? It's not a level of complexity that I have seen a need for, in the same
way that 'Accessors' just seem to be further complexity without a real need for
many users.
By using established practices and developing them as extensions that can be
disabled if not required, then we can all work with the level of complexity that
we are comfortable with? 'docblock' comments make the code readable, and can be
stripped in much the same way as javascript is 'packed' for running code, but
using the same standard as the basis for other extensions information that can
be parsed/compiled as required does have some sort of logic? The information
required is on the whole the same for the IDE and documentation and currently a
large swath of code already has all of the core comments already? Surely the
starting point is to ensure that the basic docblock standards work with all of
the 'new' features, and then everything else builds on top of that?
--
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
