diff --git a/wp-admin/includes/template.php b/wp-admin/includes/template.php index 990834d0cb..56417ba571 100644 --- a/wp-admin/includes/template.php +++ b/wp-admin/includes/template.php @@ -13,12 +13,13 @@ // /** - * Walker to output an unordered list of category checkbox elements. + * Walker to output an unordered list of category checkbox input elements. + * + * @since 2.5.1 * * @see Walker * @see wp_category_checklist() * @see wp_terms_checklist() - * @since 2.5.1 */ class Walker_Category_Checklist extends Walker { public $tree_type = 'category'; @@ -112,12 +113,15 @@ class Walker_Category_Checklist extends Walker { } /** - * Output an unordered list of checkbox elements labelled + * Output an unordered list of checkbox input elements labelled * with category names. * - * @see wp_terms_checklist() * @since 2.5.1 * + * @todo Properly document optional arguments as such. + * + * @see wp_terms_checklist() + * * @param int $post_id Mark categories associated with this post as checked. $selected_cats must not be an array. * @param int $descendants_and_self ID of the category to output along with its descendents. * @param bool|array $selected_cats List of categories to mark as checked. @@ -137,13 +141,16 @@ function wp_category_checklist( $post_id = 0, $descendants_and_self = 0, $select } /** - * Output an unordered list of checkbox elements labelled - * with term names. Taxonomy independent version of wp_category_checklist(). + * Output an unordered list of checkbox input elements labelled with term names. + * + * Taxonomy independent version of {@see wp_category_checklist()}. * * @since 3.0.0 * - * @param int $post_id - * @param array $args + * @todo Properly document optional default arguments. + * + * @param int $post_id Post ID. + * @param array $args Arguments to form the terms checklist. */ function wp_terms_checklist( $post_id = 0, $args = array() ) { $defaults = array( @@ -236,7 +243,7 @@ function wp_terms_checklist( $post_id = 0, $args = array() ) { * Retrieve a list of the most popular terms from the specified taxonomy. * * If the $echo argument is true then the elements for a list of checkbox - * elements labelled with the names of the selected terms is output. + * `` elements labelled with the names of the selected terms is output. * If the $post_ID global isn't empty then the terms associated with that * post will be marked as checked. * @@ -782,7 +789,7 @@ function touch_time( $edit = 1, $for_post = 1, $tab_index = 0, $multi = 0 ) { } /** - * Print out