Code formatting and Inline Doc improvements in wp-includes/general-template.php

[c3mdigital]

Patch is a coding standards cleanup (whitespace) for wp-includes/general-template.php. Also adds some missing @return statements in PHPDocs.

[SergeyBiryukov]

​http://wpdevel.wordpress.com/2011/03/23/code-refactoring/

There was a number of code cleanup tickets like #17997, and the consensus was that coding style fixes should be a result of more substantial changes than just improving readability.

Let's focus on PHPDocs here.

[c3mdigital]

PHPDoc fixes only

[c3mdigital]

Replying to SergeyBiryukov:

​http://wpdevel.wordpress.com/2011/03/23/code-refactoring/

There was a number of code cleanup tickets like #17997, and the consensus was that coding style fixes should be a result of more substantial changes than just improving readability.

Let's focus on PHPDocs here.

Thanks for the link. Makes a lot of sense. I updated the patch focusing only on the PHPDocs.

[SergeyBiryukov]

21893.3.patch​ brings some consistency by reusing the pattern from *_title() functions:
​http://core.trac.wordpress.org/browser/tags/3.4.2/wp-includes/general-template.php#L633

[ryan]

In [21926]:

phpdoc cleanups for general-template.php. Props c3mdigital, SergeyBiryukov. fixes #21893