Docs: Reformat `comments_pre_query`, `networks_pre_query`, `sites_pre_query` DocBlocks for better readability.

See #50768.
Built from https://develop.svn.wordpress.org/trunk@48986


git-svn-id: http://core.svn.wordpress.org/trunk@48748 1a063a9b-81f0-0310-95a4-ce76da25c4cd

wp-includes/class-wp-comment-query.php

@@ -386,10 +386,13 @@ class WP_Comment_Query {
 		 *
 		 * Return a non-null value to bypass WordPress' default comment queries.
 		 *
-		 * The expected return type from this filter depends on the value passed in the request query_vars.
-		 * When `$this->query_vars['count']` is set, the filter should return the comment count as an int.
-		 * When `'ids' === $this->query_vars['fields']`, the filter should return an array of comment IDs.
-		 * Otherwise the filter should return an array of WP_Comment objects.
+		 * The expected return type from this filter depends on the value passed
+		 * in the request query vars:
+		 * - When `$this->query_vars['count']` is set, the filter should return
+		 *   the comment count as an integer.
+		 * - When `'ids' === $this->query_vars['fields']`, the filter should return
+		 *   an array of comment IDs.
+		 * - Otherwise the filter should return an array of WP_Comment objects.
 		 *
 		 * @since 5.3.0
 		 *

wp-includes/class-wp-network-query.php

@@ -204,10 +204,13 @@ class WP_Network_Query {
 		 *
 		 * Return a non-null value to bypass WordPress' default network queries.
 		 *
-		 * The expected return type from this filter depends on the value passed in the request query_vars.
-		 * When `$this->query_vars['count']` is set, the filter should return the network count as an int.
-		 * When `'ids' === $this->query_vars['fields']`, the filter should return an array of network IDs.
-		 * Otherwise the filter should return an array of WP_Network objects.
+		 * The expected return type from this filter depends on the value passed
+		 * in the request query vars:
+		 * - When `$this->query_vars['count']` is set, the filter should return
+		 *   the network count as an integer.
+		 * - When `'ids' === $this->query_vars['fields']`, the filter should return
+		 *   an array of network IDs.
+		 * - Otherwise the filter should return an array of WP_Network objects.
 		 *
 		 * @since 5.2.0
 		 *

wp-includes/class-wp-site-query.php

@@ -295,10 +295,13 @@ class WP_Site_Query {
 		 *
 		 * Return a non-null value to bypass WordPress' default site queries.
 		 *
-		 * The expected return type from this filter depends on the value passed in the request query_vars:
-		 * When `$this->query_vars['count']` is set, the filter should return the site count as an int.
-		 * When `'ids' === $this->query_vars['fields']`, the filter should return an array of site IDs.
-		 * Otherwise the filter should return an array of WP_Site objects.
+		 * The expected return type from this filter depends on the value passed
+		 * in the request query vars:
+		 * - When `$this->query_vars['count']` is set, the filter should return
+		 *   the site count as an integer.
+		 * - When `'ids' === $this->query_vars['fields']`, the filter should return
+		 *   an array of site IDs.
+		 * - Otherwise the filter should return an array of WP_Site objects.
 		 *
 		 * @since 5.2.0
 		 *

wp-includes/version.php

@@ -13,7 +13,7 @@
  *
  * @global string $wp_version
  */
-$wp_version = '5.6-alpha-48985';
+$wp_version = '5.6-alpha-48986';
 
 /**
  * Holds the WordPress DB revision, increments when changes are made to the WordPress DB schema.