> > I think all effort should go into writing real documentation within the > phpdoc cvs module instead of unreadable and unofficial doxygen output. > Personally I feel the link to the doxygen output should be removed from > php.net/spl (but won't) so anyway those are my feelings. Etienne is planning > to work on both, which is great, but I encourage everyone to update the > official spl documentation and not worry much about doxygen. >
I agree with you on the part that efforts should be put for the phpdoc but I personally consider doxygen's output to be much more complete than any phpdoc output. The doxygen output is very technical and usually if you are looking for something very specific, you'll find it. PHPDocs and Doxygen outputs are really 2 separate beasts, for instance with Doxygen you'll see a clear hierarchy between the objects/classes and which classes they inherit and implement whereas the phpdoc will describe the functions clearly. There are many things that doxygen does that phpdoc doesn't do and the same for phpdoc and doxygen. Anyways, I think we still need that doxygen output and it would be plain bad to scrap it. D -- PHP Internals - PHP Runtime Development Mailing List To unsubscribe, visit: http://www.php.net/unsub.php
