From 135ec99ab59d00cbc39d57c148e3f15eb722287c Mon Sep 17 00:00:00 2001 From: Drew Jaynes Date: Fri, 26 Feb 2016 17:18:52 +0000 Subject: [PATCH] Docs: Add missing parameter and return notations in the DocBlock for `WP_Theme::_name_sort()`, a private `usort()` helper. See #32246. git-svn-id: https://develop.svn.wordpress.org/trunk@36737 602fd350-edb4-49c9-b593-d223f7449a82 --- src/wp-includes/class-wp-theme.php | 5 ++++- 1 file changed, 4 insertions(+), 1 deletion(-) diff --git a/src/wp-includes/class-wp-theme.php b/src/wp-includes/class-wp-theme.php index f0cce7f371..7471b506bb 100644 --- a/src/wp-includes/class-wp-theme.php +++ b/src/wp-includes/class-wp-theme.php @@ -1344,7 +1344,10 @@ final class WP_Theme implements ArrayAccess { * @static * @access private * - * @return int + * @param string $a First name. + * @param string $b Second name. + * @return int Negative if `$a` falls lower in the natural order than `$b`. Zero if they fall equally. + * Greater than 0 if `$a` falls higher in the natural order than `$b`. Used with uasort(). */ private static function _name_sort( $a, $b ) { return strnatcasecmp( $a->headers['Name'], $b->headers['Name'] );