Documentation for widget_tag_cloud_args filter is wrong

[swissspidy]

The docs say that it can be used to filter the taxonomy used in the Tag Cloud widget, but it does way more than that. Not only the taxonomy is being passed to the wp_tag_cloud() function, but instead the whole $args array:

<?php
/**
 * Filters the taxonomy used in the Tag Cloud widget.
 *
 * @since 2.8.0
 * @since 3.0.0 Added taxonomy drop-down.
 *
 * @see wp_tag_cloud()
 *
 * @param array $current_taxonomy The taxonomy to use in the tag cloud. Default 'tags'.
 */
$tag_cloud = wp_tag_cloud( apply_filters( 'widget_tag_cloud_args', array(
        'taxonomy' => $current_taxonomy,
        'echo' => false
) ) );

This needs to be reflected in the docs.

[DrewAPicture]

Second argument added in [34273] for #16125 in 4.4.

[swissspidy]

In addition to that, hash notation for the wp_tag_cloud() docblock would be great too.

[backermann]

Fixed documentation in 37654.diff​.

[jorbin]

@DrewAPicture @swissspidy Can you review this one please?

[DrewAPicture]

Sure.

[DrewAPicture]

In 39053:

Docs: Fix an incorrect pseudo-parameter referenced in the hook doc for the widget_tag_cloud_args filter.

Props backermann.
Fixes #37654.