PHPdoc effort for classes.php

[darkdragon]

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

Needed to complete:

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

[darkdragon]

Incomplete documentation for classes.php based off of r6597

[darkdragon]

Eh. Probably complete this during the summer. Patch is available for anyone who wants to take ownership of this file. Template covers everything that needs to be completed.

[darkdragon]

Remember, the revision has to match before you can apply the patch, unless there weren't too many changes. Checkout r6597, apply patch, and then update repository.

[santosj]

Yeah. There are a lot of places where inline documentation is needed and it isn't as quick as some other files. I won't be doing this until the end, because the file has difficult to understand sections of code which need more thought.

[jacobsantos]

Complete inline documentation for classes.php based off of r8889

[ryan]

(In [8900]) phpdoc for classes.php from jacobsantos. fixes #5635