Ticket #5211 (closed enhancement: fixed)
wp-settings.php documentation
| Reported by: |
|
Owned by: |
|
|---|---|---|---|
| Priority: | normal | Milestone: | 2.5 |
| Component: | Optimization | Version: | 2.5 |
| Severity: | normal | Keywords: | phpdoc documentation has-patch |
| Cc: |
Description
Documentation push for standardization of WordPress. Documents globals and defines, as well as all functions in wp-settings.php.
Might not be as high priority, since it is wp-settings.php, but it does have @since information which would make the defines and global information useful to those searching for such things and wanting to know which version without having to do as much research I as did.
Attachments
Change History
darkdragon — 4 years ago
-
attachment
wp-settings.phpdoc.4.diff
added
- Owner changed from anonymous to westi
- Status changed from new to assigned
- Milestone changed from 2.5 to 2.4
First paragraph should read:
"Documentation standardization push for WordPress mass documentation effort.
Patch adds documentation to defines, globals, and functions for wp-settings.php. Adds @since information and @deprecated information for all documented elements.
Committing isn't a high priority, but the patch should be used for reference of future documentation. Might be useful since it does document constants that are useful to plugin authors."
darkdragon — 4 years ago
-
attachment
vars-version.phpdoc.diff
added
phpdoc documentation for vars.php and version.php
comment:3
darkdragon — 4 years ago
Added documentation for vars.php and version.php. Don't know if core would want to add these, but it was pretty easy to write.
The argument for version.php is that it documents one global that is used throughout WordPress. That and @uses $wp_version would work if it had phpdoc for the global.
darkdragon — 4 years ago
-
attachment
wp-settings.phpdoc.r6311.diff
added
Updated previous patch for r6311, which caused conflicts.
- Status changed from assigned to closed
- Resolution set to fixed
I didn't upload my newest patch! Need to change the timer_start and timer_stop @since information to 0.71 instead of 1.5. Pretty much the only change between the old patch and my most recent one.
Thanks for committing. That is sweet!

Added @Since to two missing blocks