[wp-trac] [WordPress Trac] #21564: Avoid method redefinitions in docs by using unique method names for internal hooks
WordPress Trac
wp-trac at lists.automattic.com
Mon Aug 13 16:10:39 UTC 2012
#21564: Avoid method redefinitions in docs by using unique method names for
internal hooks
-------------------------+-----------------------------
Reporter: bpetty | Owner: bpetty
Type: enhancement | Status: new
Priority: normal | Milestone: Awaiting Review
Component: Inline Docs | Version: 3.4.1
Severity: normal | Keywords: needs-patch
-------------------------+-----------------------------
API documentation generators include all source files even if, in
practice, only one of these files are included per request. Many core
pages re-use the same method names for internal hooks which results in
redefinitions for the docs, and resulting in missing documentation.
In general, it's good practice to keep these internal global method names
as unique as possible anyway to avoid namespace (global scope) clashes
since they aren't intended to be used as public API.
Patch coming soon...
--
Ticket URL: <http://core.trac.wordpress.org/ticket/21564>
WordPress Trac <http://core.trac.wordpress.org/>
WordPress blogging software
More information about the wp-trac
mailing list