Ticket #19756: 19756.3.patch

.php

@@ -13 +13 @@
 //
 
 /**
- * {@internal Missing Short Description}}
+ * Walker sub-class to output an unordered list of category checkbox form elements.
+ * 
+ * @see Walker
+ * @see wp_category_checklist()
  *
  * @since 2.5.1
  */
@@ -51 +54 @@
 }
 
 /**
- * {@internal Missing Short Description}}
+ * Outputs an unordered list of checkbox elements labeled with catagory names.
  *
  * @since 2.5.1
  *
- * @param unknown_type $post_id
- * @param unknown_type $descendants_and_self
- * @param unknown_type $selected_cats
- * @param unknown_type $popular_cats
+ * @param int $post_id Optional. If provided and $selected_cats is false, categories attached to post will be checked in list.
+ * @param int $descendants_and_self Optional.  Categories will be this term id along with its descendants.
+ * @param boolean|array $selected_cats Optional.  These categories in the list will be checked.
+ * @param boolean|array $popular_cats Optional.  These categories in the list will receive the class 'popular-category'
+ * @param object $walker Optional.  Walker object used in display of list.
+ * @param boolean $checked_ontop Optional.  Display the checked items in the list first.
+ *
+ * @see Walker
  */
 function wp_category_checklist( $post_id = 0, $descendants_and_self = 0, $selected_cats = false, $popular_cats = false, $walker = null, $checked_ontop = true ) {
         wp_terms_checklist($post_id,
@@ -141 +148 @@
 }
 
 /**
- * {@internal Missing Short Description}}
+ * Get an array of the most popular term ids from a taxonomy and optionally output an
+ * unordered list of checkbox elements for the terms.  The terms that are related to the
+ * current $post_id will be checked in the list.
  *
  * @since 2.5.0
- *
- * @param unknown_type $taxonomy
- * @param unknown_type $default
- * @param unknown_type $number
- * @param unknown_type $echo
- * @return unknown
- */
-function wp_popular_terms_checklist( $taxonomy, $default = 0, $number = 10, $echo = true ) {
+ * 
+ * @uses $post_id
+ *
+ * @param string|array $taxonomies The taxonomies to retrieve terms from.
+ * @param string $depreciated Optional.  Unused.
+ * @param int $number Optional. The number of terms to return.  Default is 10.
+ * @param boolean $echo Optional.  Whether to echo as well as return the result.  Default is true.
+ * @return array An array of the term ids.
+ */
+function wp_popular_terms_checklist( $taxonomy, $default = null, $number = 10, $echo = true ) {
         global $post_ID;
 
         if ( $post_ID )