PHPdoc effort for cache.php

[darkdragon]

PHPdoc effort for wp-includes/cache.php adds inline documentation for all functions, constants, properties, and methods.

• @since version
• Parameter and return value
• Short and Long description

[darkdragon]

Incomplete documentation for cache.php based off of r6473

[darkdragon]

The methods do not have @since information in the patch. The current source that was providing what version functions were added, does not accurately provide version information for methods and classes. Also does not provide information for properties and constants.

A new source is being developed that will remedy this problem and the documentation will be completed after that.

However, anyone who wants to finish the short and long descriptions can be my guest.

[westi]

Good work . Won't commit untill we have more info

[darkdragon]

I figured as much.

Patch is if anyone else wants to join the effort. In the mean time, I'm working on cache.php now. I might finish it up. Undecided at this point, I might move over to the tickets that already have documentation and try to complete those.

I move around a lot and the cache slightly more confusing the rest, so I'll most likely put if off until later.

[darkdragon]

Complete phpdoc documentation for cache.php based off of r6542

[darkdragon]

r6539 totally pwns!

Finished the WordPress Cache API after it was greatly simplified in above revision.

[ryan]

(In [6543]) phpdoc for cache.php from darkdragon. fixes #5511