[wp-trac] [WordPress Trac] #17414: PHPDocs typos for 3.2

WordPress Trac wp-trac at lists.automattic.com
Thu May 26 05:42:56 UTC 2011


#17414: PHPDocs typos for 3.2
--------------------------+-----------------------
 Reporter:  duck_         |       Owner:  westi
     Type:  defect (bug)  |      Status:  accepted
 Priority:  normal        |   Milestone:  3.2
Component:  Inline Docs   |     Version:
 Severity:  normal        |  Resolution:
 Keywords:                |
--------------------------+-----------------------

Comment (by mfields):

 /wp-includes/taxonomy.php appears to have a few deviations from phpDoc.
 Function level Doc Blocks do not support the @package or @subpackage tags.
 It is my understanding that functions will inherit this information from
 the Page Level Doc Block. Likewise methods of classes inherit this
 information from class-level doc blocks. I believe that many of these tags
 can be removed. I'd be happy to submit a patch here if this is a good
 idea.

 http://manual.phpdoc.org/HTMLSmartyConverter/HandS/phpDocumentor/tutorial_tags.package.pkg.html

-- 
Ticket URL: <http://core.trac.wordpress.org/ticket/17414#comment:9>
WordPress Trac <http://core.trac.wordpress.org/>
WordPress blogging software


More information about the wp-trac mailing list