Index: src/wp-includes/category-template.php
===================================================================
--- src/wp-includes/category-template.php	(revision 42215)
+++ src/wp-includes/category-template.php	(working copy)
@@ -668,7 +668,49 @@
  * @since 2.3.0
  * @since 4.8.0 Added the `show_count` argument.
  *
- * @param array|string|null $args Optional. Override default arguments.
+ * @param array|string|null $args {
+ *     Optional. Override default arguments.
+ *
+ *     @type int            $smallest    Smallest font size used to display tags. Paired
+ *                                       with the value of `$unit`, to determine CSS text
+ *                                       size unit. Default 8 (pt).
+ *     @type int            $largest     Largest font size used to display tags. Paired
+ *                                       with the value of `$unit`, to determine CSS text
+ *                                       size unit. Default 22 (pt).
+ *     @type string         $unit        CSS text size unit to use with the `$smallest`
+ *                                       and `$largest` values. Accepts any valid CSS text
+ *                                       size unit. Default 'pt'.
+ *     @type int            $number      The number of tags to return. Accepts any
+ *                                       positive integer or zero to return all.
+ *                                       Default 0.
+ *     @type string         $format      Format to display the tag cloud in. Accepts 'flat'
+ *                                       (tags separated with spaces), 'list' (tags displayed
+ *                                       in an unordered list), or 'array' (returns an array).
+ *                                       Default 'flat'.
+ *     @type string         $separator   HTML or text to separate the tags. Default "\n" (newline).
+ *     @type string         $orderby     Value to order tags by. Accepts 'name' or 'count'.
+ *                                       Default 'name'. The {@see 'tag_cloud_sort'} filter
+ *                                       can also affect how tags are sorted.
+ *     @type string         $order       How to order the tags. Accepts 'ASC' (ascending),
+ *                                       'DESC' (descending), or 'RAND' (random). Default 'ASC'.
+ *     @type string         $exclude     Comma separated list of tags (term_id) to exclude.
+ *                                       For example, exclude=5,27 means tags that have the term_id 5 or 27
+ *                                       will NOT be displayed. Default: null.
+ *     @type string         $include     Comma separated list of tags (term_id) to include.
+ *                                       For example, include=5,27 means tags that have the term_id 5 or 27
+ *                                       will NOT be displayed. Default: null.
+ *     @type string         $link        Set link to allow edit of a particular tag. Accepts 'view' and 'edit'.
+ *                                       Default: view.
+ *     @type string|array   $taxonomy    Taxonomy or array of taxonomies to use in generating the cloud.
+ *                                       Accepts any registered taxonomy or array of taxonomies (as of Version 3.1).
+ *                                       Default: post_tag.
+ *     @type string         $post_type   Post type passed to edit.php for the popular tags edit links.
+ *                                       Used only when $link is set to 'edit'.
+ *     @type boolean        $echo        Display the result or return it in a variable.
+ *                                       Default: true.
+ *     @type bool|int       $show_count  Whether to display the tag counts. Default 0. Accepts
+ *                                       0, 1, or their bool equivalents.
+ * }
  * @return void|array Generated tag cloud, only if no failures and 'array' is set for the 'format' argument.
  *                    Otherwise, this function outputs the tag cloud.
  */