Changeset 47122 for trunk/src/wp-includes/class-wp-user-query.php

Timestamp:

01/29/2020 12:43:23 AM (6 years ago)

Author:

SergeyBiryukov

Message:

Docs: Improve inline comments per the documentation standards.

Includes minor code layout fixes for better readability.

See #48303.

File:

• trunk/src/wp-includes/class-wp-user-query.php (modified) (4 diffs)

trunk/src/wp-includes/class-wp-user-query.php

@@ -59 +59 @@
         private $compat_fields = array( 'results', 'total_users' );
 
-        // SQL clauses
+        // SQL clauses.
         public $query_fields;
         public $query_from;
@@ -440 +440 @@
                 }
 
-                // sorting
+                // Sorting.
                 $qv['order'] = isset( $qv['order'] ) ? strtoupper( $qv['order'] ) : '';
                 $order       = $this->parse_order( $qv['order'] );
@@ -490 +490 @@
                 $this->query_orderby = 'ORDER BY ' . implode( ', ', $orderby_array );
 
-                // limit
+                // Limit.
                 if ( isset( $qv['number'] ) && $qv['number'] > 0 ) {
                         if ( $qv['offset'] ) {
@@ -764 +764 @@
                         $_orderby = 'display_name';
                 } elseif ( 'post_count' == $orderby ) {
-                        // todo: avoid the JOIN
+                        // @todo Avoid the JOIN.
                         $where             = get_posts_by_author_sql( 'post' );
                         $this->query_from .= " LEFT OUTER JOIN (