Ticket #5211 (closed enhancement: fixed)

Opened 4 years ago

Last modified 4 years ago

wp-settings.php documentation

Reported by: darkdragon Owned by: westi
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

wp-settings.phpdoc.4.diff Download (7.3 KB) - added by darkdragon 4 years ago.
Added @Since to two missing blocks
vars-version.phpdoc.diff Download (1.6 KB) - added by darkdragon 4 years ago.
phpdoc documentation for vars.php and version.php
wp-settings.phpdoc.r6311.diff Download (6.8 KB) - added by darkdragon 4 years ago.
Updated previous patch for r6311, which caused conflicts.

Change History

Added @Since to two missing blocks

  • 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."

phpdoc documentation for vars.php and version.php

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.

Updated previous patch for r6311, which caused conflicts.

  • Status changed from assigned to closed
  • Resolution set to fixed

(In [6434]) phpdoc for wp-settings.php. Fixes #5211 props darkdragon.

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!

(In [6437]) Fix @since for timer_start and timer_stop. See #5211.

Note: See TracTickets for help on using tickets.