Changeset 48473 for trunk/src/wp-includes/comment-template.php

Timestamp:

07/14/2020 11:54:26 AM (5 years ago)

Author:

johnbillion

Message:

Docs: Correct and improve inline docs for parameters that accept a callback function.

See #49572

File:

• trunk/src/wp-includes/comment-template.php (modified) (1 diff)

trunk/src/wp-includes/comment-template.php

@@ -2008 +2008 @@
  *     Optional. Formatting options.
  *
- *     @type object $walker            Instance of a Walker class to list comments. Default null.
- *     @type int    $max_depth         The maximum comments depth. Default empty.
- *     @type string $style             The style of list ordering. Default 'ul'. Accepts 'ul', 'ol'.
- *     @type string $callback          Callback function to use. Default null.
- *     @type string $end-callback      Callback function to use at the end. Default null.
- *     @type string $type              Type of comments to list.
- *                                     Default 'all'. Accepts 'all', 'comment', 'pingback', 'trackback', 'pings'.
- *     @type int    $page              Page ID to list comments for. Default empty.
- *     @type int    $per_page          Number of comments to list per page. Default empty.
- *     @type int    $avatar_size       Height and width dimensions of the avatar size. Default 32.
- *     @type bool   $reverse_top_level Ordering of the listed comments. If true, will display newest comments first.
- *     @type bool   $reverse_children  Whether to reverse child comments in the list. Default null.
- *     @type string $format            How to format the comments list.
- *                                     Default 'html5' if the theme supports it. Accepts 'html5', 'xhtml'.
- *     @type bool   $short_ping        Whether to output short pings. Default false.
- *     @type bool   $echo              Whether to echo the output or return it. Default true.
+ *     @type object   $walker            Instance of a Walker class to list comments. Default null.
+ *     @type int      $max_depth         The maximum comments depth. Default empty.
+ *     @type string   $style             The style of list ordering. Default 'ul'. Accepts 'ul', 'ol'.
+ *     @type callable $callback          Callback function to use. Default null.
+ *     @type callable $end-callback      Callback function to use at the end. Default null.
+ *     @type string   $type              Type of comments to list.
+ *                                       Default 'all'. Accepts 'all', 'comment', 'pingback', 'trackback', 'pings'.
+ *     @type int      $page              Page ID to list comments for. Default empty.
+ *     @type int      $per_page          Number of comments to list per page. Default empty.
+ *     @type int      $avatar_size       Height and width dimensions of the avatar size. Default 32.
+ *     @type bool     $reverse_top_level Ordering of the listed comments. If true, will display newest comments first.
+ *     @type bool     $reverse_children  Whether to reverse child comments in the list. Default null.
+ *     @type string   $format            How to format the comments list.
+ *                                       Default 'html5' if the theme supports it. Accepts 'html5', 'xhtml'.
+ *     @type bool     $short_ping        Whether to output short pings. Default false.
+ *     @type bool     $echo              Whether to echo the output or return it. Default true.
  * }
  * @param WP_Comment[] $comments Optional. Array of WP_Comment objects.