From 05e0d7c3c394ded71b3fc22c2f9526fa9e30aaf7 Mon Sep 17 00:00:00 2001
From: Drew Jaynes <info@drewapicture.com>
Date: Fri, 18 Dec 2015 23:38:26 +0000
Subject: [PATCH] Docs: Add missing parameter and return descriptions to the
 DocBlocks for `_wp_object_name_sort_cb()` and `_wp_object_count_sort_cb()`,
 both `uasort()` callbacks.

See #32246.

Built from https://develop.svn.wordpress.org/trunk@36013


git-svn-id: http://core.svn.wordpress.org/trunk@35978 1a063a9b-81f0-0310-95a4-ce76da25c4cd
---
 wp-includes/category-template.php | 19 +++++++++++++++----
 wp-includes/version.php           |  2 +-
 2 files changed, 16 insertions(+), 5 deletions(-)

diff --git a/wp-includes/category-template.php b/wp-includes/category-template.php
index e452ccda25..b989ed526c 100644
--- a/wp-includes/category-template.php
+++ b/wp-includes/category-template.php
@@ -947,22 +947,33 @@ function wp_generate_tag_cloud( $tags, $args = '' ) {
 }
 
 /**
- * Callback for comparing objects based on name
+ * Serves as a callback for comparing objects based on name.
+ *
+ * Used with `uasort()`.
  *
  * @since 3.1.0
  * @access private
- * @return int
+ *
+ * @param object $a The first object to compare.
+ * @param object $b The second object to compare.
+ * @return int Negative number if `$a->name` is less than `$b->name`, zero if they are equal,
+ *             or greater than zero if `$a->name` is greater than `$b->name`.
  */
 function _wp_object_name_sort_cb( $a, $b ) {
 	return strnatcasecmp( $a->name, $b->name );
 }
 
 /**
- * Callback for comparing objects based on count
+ * Serves as a callback for comparing objects based on count.
+ *
+ * Used with `uasort()`.
  *
  * @since 3.1.0
  * @access private
- * @return bool
+ *
+ * @param object $a The first object to compare.
+ * @param object $b The second object to compare.
+ * @return bool Whether the count value for `$a` is greater than the count value for `$b`.
  */
 function _wp_object_count_sort_cb( $a, $b ) {
 	return ( $a->count > $b->count );
diff --git a/wp-includes/version.php b/wp-includes/version.php
index 188662fba4..a60f716f31 100644
--- a/wp-includes/version.php
+++ b/wp-includes/version.php
@@ -4,7 +4,7 @@
  *
  * @global string $wp_version
  */
-$wp_version = '4.5-alpha-36012';
+$wp_version = '4.5-alpha-36013';
 
 /**
  * Holds the WordPress DB revision, increments when changes are made to the WordPress DB schema.