[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