PHPdoc effort for pluggable.php

[darkdragon]

PHPdoc efforts for pluggable.php enhances the inline documentation of the file.

• Adds @since information
• Documents deprecated pluggable functions
• Documents file level for xref and phpdocumentor sites.
• Adds all functions to WordPress package
• Has short and long descriptions
• Documents parameters and return values

[darkdragon]

Incomplete documentation for pluggables.php based off of r6473

[darkdragon]

If you are wondering what relevance the patch has, most of the work is at the bottom and goes up, since I usually use Zend Studio to document the parameters and return values working down and then add the @since, short/long descriptions going back up.

Description is based on completed documentation, which this the current patch isn't there yet.

[westi]

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

[darkdragon]

Still incomplete phpdoc based off of 6582

[darkdragon]

Just finished documention for pluggable functions, based off of r6597

[darkdragon]

Patch for r6597, just has completed function documentation or as close to complete as possible.

[ryan]

(In [6600]) phpdoc for pluggable from darkdragon. fixes #5509

[darkdragon]

Committed phpdoc comments only covers a small portion of full file, but currently the only ones I have completed or almost completed portions.

It will allow for uploading a new template patch for anyone else who wishes to complete the file to have less work to do.

[darkdragon]

Completed phpdoc for pluggable.php based on r6636

[darkdragon]

Last patch which completes ticket. All other corrections probably belong in #5611.

[ryan]

(In [6637]) phpdoc for pluggable.php from darkdragon. fixes #5509