From 391fc25eeda23dd84b43268934e4673584c993eb Mon Sep 17 00:00:00 2001
From: John Blackbourn <johnbillion@git.wordpress.org>
Date: Sat, 20 Feb 2021 17:10:11 +0000
Subject: [PATCH] Docs: Various docblock corrections and improvements.

See #51800

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


git-svn-id: http://core.svn.wordpress.org/trunk@50006 1a063a9b-81f0-0310-95a4-ce76da25c4cd
---
 wp-includes/class-wp-site.php       |  4 +++-
 wp-includes/class-wp-term-query.php |  2 --
 wp-includes/load.php                | 18 +++++++++++++++
 wp-includes/theme.php               | 35 ++++++++++++++++++++++++-----
 wp-includes/version.php             |  2 +-
 5 files changed, 51 insertions(+), 10 deletions(-)

diff --git a/wp-includes/class-wp-site.php b/wp-includes/class-wp-site.php
index e1839fed9e..1e253ec636 100644
--- a/wp-includes/class-wp-site.php
+++ b/wp-includes/class-wp-site.php
@@ -27,6 +27,8 @@ final class WP_Site {
 	/**
 	 * Site ID.
 	 *
+	 * Named "blog" vs. "site" for legacy reasons.
+	 *
 	 * A numeric string, for compatibility reasons.
 	 *
 	 * @since 4.5.0
@@ -64,7 +66,7 @@ final class WP_Site {
 	public $site_id = '0';
 
 	/**
-	 * The date on which the site was created or registered.
+	 * The date and time on which the site was created or registered.
 	 *
 	 * @since 4.5.0
 	 * @var string Date in MySQL's datetime format.
diff --git a/wp-includes/class-wp-term-query.php b/wp-includes/class-wp-term-query.php
index 0f679535c3..465bcb7156 100644
--- a/wp-includes/class-wp-term-query.php
+++ b/wp-includes/class-wp-term-query.php
@@ -331,8 +331,6 @@ class WP_Term_Query {
 	 *   - 'ids'
 	 *   - 'tt_ids'
 	 *
-	 * In all cases, a `WP_Error` object will be returned if an invalid taxonomy is used.
-	 *
 	 * @since 4.6.0
 	 *
 	 * @global wpdb $wpdb WordPress database abstraction object.
diff --git a/wp-includes/load.php b/wp-includes/load.php
index a68e6db435..897e018ab3 100644
--- a/wp-includes/load.php
+++ b/wp-includes/load.php
@@ -417,6 +417,24 @@ function wp_debug_mode() {
 	 * constants to not be checked and the default PHP values for errors
 	 * will be used unless you take care to update them yourself.
 	 *
+	 * To use this filter you must define a `$wp_filter` global before
+	 * WordPress loads, usually in `wp-config.php`.
+	 *
+	 * Example:
+	 *
+	 *     $GLOBALS['wp_filter'] = array(
+	 *         'enable_wp_debug_mode_checks' => array(
+	 *             10 => array(
+	 *                 array(
+	 *                     'accepted_args' => 0,
+	 *                     'function'      => function() {
+	 *                         return false;
+	 *                     },
+	 *                 ),
+	 *             ),
+	 *         ),
+	 *     );
+	 *
 	 * @since 4.6.0
 	 *
 	 * @param bool $enable_debug_mode Whether to enable debug mode checks to occur. Default true.
diff --git a/wp-includes/theme.php b/wp-includes/theme.php
index 916c836f43..458b8e6b3a 100644
--- a/wp-includes/theme.php
+++ b/wp-includes/theme.php
@@ -2485,12 +2485,35 @@ function get_theme_starter_content() {
  *
  * @global array $_wp_theme_features
  *
- * @param string $feature The feature being added. Likely core values include 'post-formats', 'post-thumbnails',
- *                        'custom-header', 'custom-background', 'custom-logo', 'menus', 'automatic-feed-links',
- *                        'html5', 'title-tag', 'customize-selective-refresh-widgets', 'starter-content',
- *                        'responsive-embeds', 'align-wide', 'dark-editor-style', 'disable-custom-colors',
- *                        'disable-custom-font-sizes', 'editor-color-palette', 'editor-font-sizes',
- *                        'editor-styles', 'wp-block-styles', and 'core-block-patterns'.
+ * @param string $feature The feature being added. Likely core values include:
+ *                          - 'admin-bar'
+ *                          - 'align-wide'
+ *                          - 'automatic-feed-links'
+ *                          - 'core-block-patterns'
+ *                          - 'custom-background'
+ *                          - 'custom-header'
+ *                          - 'custom-line-height'
+ *                          - 'custom-logo'
+ *                          - 'customize-selective-refresh-widgets'
+ *                          - 'custom-spacing'
+ *                          - 'custom-units'
+ *                          - 'dark-editor-style'
+ *                          - 'disable-custom-colors'
+ *                          - 'disable-custom-font-sizes'
+ *                          - 'editor-color-palette'
+ *                          - 'editor-gradient-presets'
+ *                          - 'editor-font-sizes'
+ *                          - 'editor-styles'
+ *                          - 'featured-content'
+ *                          - 'html5'
+ *                          - 'menus'
+ *                          - 'post-formats'
+ *                          - 'post-thumbnails'
+ *                          - 'responsive-embeds'
+ *                          - 'starter-content'
+ *                          - 'title-tag'
+ *                          - 'wp-block-styles'
+ *                          - 'widgets'
  * @param mixed  ...$args Optional extra arguments to pass along with certain features.
  * @return void|false Void on success, false on failure.
  */
diff --git a/wp-includes/version.php b/wp-includes/version.php
index 25e11d2e4d..4a90bd8ffc 100644
--- a/wp-includes/version.php
+++ b/wp-includes/version.php
@@ -13,7 +13,7 @@
  *
  * @global string $wp_version
  */
-$wp_version = '5.7-beta3-50394';
+$wp_version = '5.7-beta3-50395';
 
 /**
  * Holds the WordPress DB revision, increments when changes are made to the WordPress DB schema.