[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