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

Incomplete documentation for pluggables.php based off of r6473

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.

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

Still incomplete phpdoc based off of 6582

Just finished documention for pluggable functions, based off of r6597

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

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

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.

Completed phpdoc for pluggable.php based on r6636

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

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