Opened 12 years ago
Closed 12 years ago
#21564 closed enhancement (fixed)
Avoid method redefinitions in docs by using unique method names for internal hooks
Reported by: | bpetty | Owned by: | nacin |
---|---|---|---|
Milestone: | 3.5 | Priority: | normal |
Severity: | normal | Version: | 3.4.1 |
Component: | Administration | Keywords: | has-patch |
Focuses: | Cc: |
Description
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...
Attachments (3)
Change History (12)
#6
@
12 years ago
Updated patch leaves display_header() alone in wp-admin/install.php, but still changes the rest.
Note: See
TracTickets for help on using
tickets.
I think we might need to keep display_header() in install.php, as that file can be running custom code via wp-content/install.php that could refer to it. Changing it in setup-config.php is simple enough, though. The rest looks fine.