Huh, I think, I cannot understand what is your point. Would you like to provide one selection for user note additions that it is note or example?What I would also like to see in user notes are the examples. Something that allows someone to choose whether it is a note or this adds an additional example of usage for the given function.Not sure if I render you the idea, but the point is to have a comments of the function and the code serving as a sample of usage separate and clearer, perhaps even highlighted.
I have heard some rumors about someone creating a proto check script to check whether the protos in phpdoc reflect the current protos of functions in the php source. Take in account undocumented new parameters, etc. too... I don't think that anybody can get on this to do it manually in any reasonable time...Also, i think when rethinking the docs we should update the protos where the return types are confusing. With move from PHP3 to PHP4 many functions changed to return True and false instead of 1 and -1. This I addressed in a message a few month ago: http://groups.google.com/groups?q=maxim+maletsky+phpdoc&start=10&hl=en&lr=&ie=UTF-8&oe=UTF-8&selm=20021109043833.EF1C.MAXIM%40php.net&rnum=18 the answer I got was: "we've got no time - go ahead". It's kind of a lot of work here. can we approach it with some more clever method? Is that important anyway? I'd like this to be fixed, though.
Goba
--
PHP Documentation Mailing List (http://www.php.net/)
To unsubscribe, visit: http://www.php.net/unsub.php
