[wp-trac] Re: [WordPress Trac] #4742: phpdoc for taxonomy API

[WordPress Trac]

#4742: phpdoc for taxonomy API
-----------------------------+----------------------------------------------
 Reporter:  ryan             |        Owner:  anonymous  
     Type:  defect           |       Status:  new        
 Priority:  normal           |    Milestone:  2.3 (trunk)
Component:  Administration   |      Version:  2.3        
 Severity:  normal           |   Resolution:             
 Keywords:  taxonomy phpdoc  |  
-----------------------------+----------------------------------------------
Comment (by darkdragon):

 Holy crap, you'll find that some functions that short and long
 descriptions in between others which don't. If the function was easy
 enough to decipher, I went ahead and filled out the information.

 I figure it is easier to complete the param and return information first
 and then go back when the information is more clear.

 Note: I place some extra non-phpdoc tags for some of the filters. Given
 that non-phpDoc tags won't show up and that the rest of the information is
 in a @internal tag, I would assume that it won't adversely affect the
 output. It would allow for a custom plugin or solution to take the tag (if
 written in PHP5 (be easier at least) ) and output all of the filter and
 actions information without having to do a search for add_action of
 add_filter functions. Just thought it might be useful.

-- 
Ticket URL: <http://trac.wordpress.org/ticket/4742#comment:5>
WordPress Trac <http://trac.wordpress.org/>
WordPress blogging software