Docblock improvements for 5.4

[desrosj]

Previously:

• #47110 (5.3)
• #46543 (5.2)
• #42505 (5.1)
• #41017 (4.9)
• #39130 (4.8)
• #37770 (4.7)
• #32246 (4.6)

[marekdedic]

I didn't know about this tracking ticket for all the small docs issues, so I created a lot of small ones (sorry...)

#48343

$args documentation for WP_Customize_Control::__construct() and WP_Customize_Manager::add_control() don't match

#48344

WP_Customize_Panel::__construct() is missing `$args` documentation

#48346

WP_Customize_Section::__construct() is missing `$args` documentation

#48347

WP_Customize_Setting::__construct() is missing `$args` documentation

#48348

WP_Customize_Color_Control::__construct should link to parent constructor for $args

#48349

Requests::request_multiple() should have the option documentation in phpDoc

#48350

Stricter docs for WP_Http::processHeaders()

#48351

Stricter docs for WP_Http::processResponse()

#48352

Stricter docs for deactivate_plugins

#48353

Stricter docs for esc_url

#48354

Stricter docs for is_page() and WP_Query::is_page()

[marekdedic]

wp_enqueue_script, wp_enqueue_style, wp_register_script and wp_register_style parameter $deps could be narrowed from array to string[].

[marekdedic]

wp_unslash parameter and return value could be narrowed from string|array to string|string[].

[Marcio Zebedeu]

adding documentation > Ticket #48348

[Marcio Zebedeu]

adding documentation > Ticket #48348

[Marcio Zebedeu]

made the change from wordpress to WordPress

[SergeyBiryukov]

In 46591:

Docs: Improve formatting of various WP_Screen DocBlocks.

See #48303.

[johnbillion]

In 46594:

Docs: Miscellaneous docblock fixes and improvements.

See #48303

[johnbillion]

In 46595:

Docs: Switch to typed array notation for the docs for asset dependency functions.

Props marekdedic

See #48303

[johnbillion]

In 46596:

Docs: Switch more docs over to typed array notation, plus some fixes.

See #48303, #41756

[johnbillion]

In 46597:

Docs: Update the docs for the error parameter that gets passed around during filesystem credential collection.

See #48303

[johnbillion]

In 46598:

Docs: Add missing docs for the auth_cookie_bad_session_token action.

See #48303

[johnbillion]

In 46599:

Docs: Correct and improve inline docs for the file type functions.

See #48303

[SergeyBiryukov]

In 46600:

Docs: Improve DocBlock formatting in WP_Block_Styles_Registry per the documentation standards.

See #48303.

[johnbillion]

In 46603:

Docs: Correct invalid hook docblocks.

See #48303

[johnbillion]

In 46604:

Docs: Correct invalid hook docblock placement.

See #48303

[SergeyBiryukov]

In 46607:

Docs: Restore correct placement for duplicate hook reference in render_block_core_latest_comments().

Previously fixed in [46604], accidentally reverted in [46606].

See #48447, #48303.

[johnbillion]

In 46608:

Docs: Remove some funky nested filters.

See #48303

[johnbillion]

In 46609:

Docs: Coding standards fix after [46608].

See #48303

[johnbillion]

In 46610:

Docs: Miscellaneous docblock corrections.

See #48303

[johnbillion]

In 46623:

Docs: Correct some incorrect docblock tags.

See #48303

[johnbillion]

In 46624:

Docs: Correct some more invalid inline docs.

See ​https://make.wordpress.org/core/handbook/best-practices/inline-documentation-standards/php/#summary-formerly-short-description

See #48303

[SergeyBiryukov]

In 46630:

Docs: Correct @see references for PHP 4 constructors in wp-includes/class-json.php.

See #48252, #48303.

[spenserhale]

Attached patch for #48352

[johnbillion]

In 46644:

Docs: Fix some incorrect return tags in docblocks.

See #48303

[Marcio Zebedeu]

Replying to johnbillion:

In 46644:

Docs: Fix some incorrect return tags in docblocks.

See #48303

I'll fix it.

[SergeyBiryukov]

In 46647:

Docs: Correct some array hash notations added in [46644].

See #48303.

[Marcio Zebedeu]

Corrected array hash notations

[Marcio Zebedeu]

Replying to SergeyBiryukov:

In 46647:

Docs: Correct some array hash notations added in [46644].

See #48303.

Can you please confirm? I had my doubts about naming patch.

[johnbillion]

In 46652:

Docs: Correct and improve the readability of some parameters of WP_Term_Query.

See #48303

[johnbillion]

In 46660:

Docs: Improve documentation of known return types, plus other docs fixes.

See #48303

[johnbillion]

In 46661:

Docs: Further improve documentation of known return types, plus other docs fixes.

See #48303

[johnbillion]

In 46662:

Docs: Docs on docs. Further improve documentation of known return types, plus other docs fixes.

See #48303

[SergeyBiryukov]

In 46691:

Docs: Move the @link tag for Customize API in WP_Customize_Manager::add_setting() and WP_Customize_Setting to a more appropriate place.

See #48303.

[Marcio Zebedeu]

Docs: Moved the @link tag for Customize API in WP_Customize_Manager::add_setting() and WP_Customize_Setting

[Marcio Zebedeu]

Replying to SergeyBiryukov:

In 46691:

Docs: Move the @link tag for Customize API in WP_Customize_Manager::add_setting() and WP_Customize_Setting to a more appropriate place.

See #48303.

done

[SergeyBiryukov]

Replying to Marcio Zebedeu:

Can you please confirm? I had my doubts about naming patch.

Thanks for the patches! However, [46647] and [46691] are changesets, not tasks. These are changes that are already committed and generally don't require additional patches, unless you notice a typo or any other inaccuracy :)

[Marcio Zebedeu]

Replying to SergeyBiryukov:

Replying to Marcio Zebedeu:

Can you please confirm? I had my doubts about naming patch.

Thanks for the patches! However, [46647] and [46691] are changesets, not tasks. These are changes that are already committed and generally don't require additional patches, unless you notice a typo or any other inaccuracy :)

Oh...thank. I'm still learning :)

[SergeyBiryukov]

In 46695:

Docs: Miscellaneous docblock corrections in wp-admin/includes/plugin.php.

See #48303.

[SergeyBiryukov]

In 46696:

Docs: In various @return tags, list the expected type first, instead of WP_Error.

See #48303.

[johnbillion]

In 46729:

Docs: Correct some invalid hook docblocks.

See #48303

[SergeyBiryukov]

In 46760:

Docs: Adjust wp_is_json_request() and wp_is_xml_request() return value descriptions for consistency.

See #48771, #48303.