PHPdoc effort for updating kses.php

[darkdragon]

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

Needed to complete:

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

[darkdragon]

Almost complete documentation for kses.php external library based off of r6597

[darkdragon]

New patch includes @since version numbers. Includes all of the parameter types and most of the descriptions. Includes all of the return types and most of the descriptions. Has most of the short and long descriptions based on the previous documentation.

Second patch should completely finish documentation for external Kses library. Perhaps the only external library worthy enough to get documentation.

I do understand that Kses is technically external to WordPress, but I think that as much as it is part of WordPress that documentation will help explain it to developers.

I will not submit documentation up stream to the original Kses library location.

[darkdragon]

Complete phpdoc documentation for kses.php based off of r6603

[darkdragon]

New patch completes all of the Kses inline documentation.

[darkdragon]

Updated patch based on r6617, which might have caused previous patch to go stale.

[darkdragon]

New patch updates completed patch based off of r6617, which might have caused the previous patch to go stale.

Is it possible given the scope of changes and support of Kses that has been made to have this patch go in?

[ryan]

(In [6630]) phpdoc for kses from darkdragon. fixes #5641