Inline Documentation for category-template.php

[darkdragon]

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

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 category-template.php based off of r6597

[anonymized_218323]

I have a patch for this, which starts and completes a lot of the documentation. I should have this completed before 2.7 is released.

[jacobsantos]

Updated patch for r8786.

[jacobsantos]

category-template.php skeleton inline documentation based off of r8947

[jacobsantos]

Skeleton inline documentation for category-template.php. The patch is based off of r8947.

[jacobsantos]

Complete inline documentation for category-template.php based off of r8970

[jacobsantos]

Has complete inline documentation.

[azaozz]

(In [8975]) Complete inline documentation for category-template.php, props jacobsantos, fixes #5634

The check for whether a theme shouldn't be covered in the old test_switch_theme() method may be inaccurate because:

• The block-templates theme support for block themes is added dynamically via wp_enable_block_templates(), so checking for that isn't reliable.
• The conditions used in wp_enable_block_templates() should be used instead.

Related to #5634.

Trac ticket:

@mukeshpanchal27 So just to confirm, this PR fixes the PHPUnit test failures you got from TT4?

@mukeshpanchal27 So just to confirm, this PR fixes the PHPUnit test failures you got from TT4?

@felixarntz yes it will fixed the unit tests issue.

Committed in https://core.trac.wordpress.org/changeset/57104