PHPdoc effort for functions.php

[darkdragon]

PHPdoc effort seeks to complete phpdoc style inline documentation for wp-includes/functions.php.

Needed to complete:

1. Short and Long Descriptions.
2. @since version info
3. parameter type and description.
4. return type and description.

Incomplete documentation for functions.php based off of r6597

Will complete in the Summer, if no one else finishes this file.

Anyone looking to take ownership can apply the patch which has templates for most of the functions to revision r6597, then update.

Partial file completion of functions.php based off of r8088

(In [8092]) PHPDoc updates for functions.php. See #5639 props jacobsantos.

PHPdoc inline documentation for functions.php based off of r8211

More functions are completed in the file.

(In [8215]) phpdoc updates from jacobsantos. see #5639

PHPdoc inline documentation for functions.php based off of r8259

functions.phpdoc.r8259.diff patch is ready to go with a few things to consider:

1. I also include style formatting fixes, that might already have been committed already.
2. I remove a global from the get_alloptions() function that doesn't appear to be used within the function.

(In [8598]) phpdoc for functions.php. Props jacobsantos. fixes #5639

Completes Functions.php inline documentation for 2.6 branch (r8605)

Completes Functions.php inline documentation for trunk (r8605)

Patches, complete functions.php for 2.6 and Trunk. Well, there is do_enclosed() function left, but I have no idea what it is for.

(In [8606]) phpdoc for general functions. See #5639 props jacobsantos.

Complete functions.php file based off of r8607.

Patch completes all of the functions in functions.php.

(In [8608]) Final phpdoc for functions. Fixes #5639 props jacobsantos.