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 (