Docblock improvements for WP 5.8

[SergeyBiryukov]

Previously:

• #51800 (5.7)
• #50768 (5.6)
• #49572 (5.5)
• #48303 (5.4)
• #47110 (5.3)
• #46543 (5.2)
• #42505 (5.1)
• #41017 (4.9)
• #39130 (4.8)
• #37770 (4.7)
• #32246 (4.6)

[SergeyBiryukov]

In 50434:

Docs: Correct function name in add_settings_field() DocBlock.

See #52628.

[SergeyBiryukov]

In 50460:

Docs: Clarify a comment about wp_opcache_invalidate() in _copy_dir().

Follow-up to [48160].

See #52628.

[SergeyBiryukov]

In 50484:

Docs: Update documentation in some WP_REST_Request tests per the documentation standards.

Follow-up to [49329].

See #52628.

[SergeyBiryukov]

In 50491:

Docs: Update inline comments in some test files per the documentation standards.

See #52628.

[johnbillion]

In 50505:

Docs: Add examples of possible names for various hooks whose name contains a dynamic portion.

This provides greater discoverability of such hooks in search results on the Code Reference site as well as increased clarity when reading the source.

See #50734, #52628

[peterwilsoncc]

In 50516:

Docs: Improve compatibility comment in WP_List_Table.

Improve comment explaining backward compatibility check for the primary column in WP_List_Table::get_column_info().

Unprops helen, markjaquith.
See #52628, #34564.

[jeremyfelt]

Replying to peterwilsoncc:

In 50516:

"added as a forth item" should be "added as a fourth item" :)

[peterwilsoncc]

In 50517:

Docs: Improve spelling in [50516].

Props jeremyfelt.
See #52628, #34564.

[SergeyBiryukov]

In 50531:

Docs: Correct DocBlock formatting for register_block_style_handle().

Follow-up to [48141].

See #52628.

[SergeyBiryukov]

In 50532:

Docs: Synchronize $category_name description in WP_Block_Pattern_Categories_Registry methods.

Follow-up to [48156].

See #52628.

[SergeyBiryukov]

In 50562:

Docs: Fix typo in pre_term_link filter description.

See #52628.

[sabernhardt]

52628.htmlhint.diff​ corrects docblock from r41558

[davidbaumwald]

Thanks for the patch, @sabernhardt. I found another instance of $htmlhint being improperly described in another docblock on line 3537 in wp-includes/general-template.php. I'll address that one as well in the commit that follows.

[davidbaumwald]

In 50583:

Docs: Fix description for $htmlhint argument in code editor settings.

Introduced in [41558].

Props sabernhardt.
See #52628.

[SergeyBiryukov]

In 50610:

Docs: Spell "non-existent" in a consistent way.

See #52628.

[SergeyBiryukov]

In 50781:

Docs: Add a @since note to wp_mail() about using is_email() for validation.

Follow-up to [48645].

See #52628.