From 9ffee539abe9de93a97e30e5e5bf6c64439a68d4 Mon Sep 17 00:00:00 2001
From: audrasjb <audrasjb@git.wordpress.org>
Date: Wed, 14 Jun 2023 14:08:18 +0000
Subject: [PATCH] Docs: Use third-person singular verbs in various function
 descriptions, as per docblocks standards.

Follow-up to [55911], [55916].

Props costdev.
See #57840.



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


git-svn-id: http://core.svn.wordpress.org/trunk@55429 1a063a9b-81f0-0310-95a4-ce76da25c4cd
---
 wp-admin/admin-header.php    | 2 +-
 wp-admin/admin.php           | 2 +-
 wp-admin/customize.php       | 2 +-
 wp-admin/export.php          | 2 +-
 wp-admin/index.php           | 2 +-
 wp-admin/link-parse-opml.php | 8 ++++++--
 wp-admin/my-sites.php        | 2 +-
 wp-admin/site-health.php     | 4 ++--
 wp-admin/update-core.php     | 2 +-
 wp-includes/version.php      | 2 +-
 10 files changed, 16 insertions(+), 12 deletions(-)

diff --git a/wp-admin/admin-header.php b/wp-admin/admin-header.php
index eebe96f36b..fc836c20a2 100644
--- a/wp-admin/admin-header.php
+++ b/wp-admin/admin-header.php
@@ -109,7 +109,7 @@ var ajaxurl = '<?php echo esc_js( admin_url( 'admin-ajax.php', 'relative' ) ); ?
 <?php
 
 /**
- * Enqueue scripts for all admin pages.
+ * Fires when enqueuing scripts for all admin pages.
  *
  * @since 2.8.0
  *
diff --git a/wp-admin/admin.php b/wp-admin/admin.php
index 3718b47c3c..455620f1c7 100644
--- a/wp-admin/admin.php
+++ b/wp-admin/admin.php
@@ -348,7 +348,7 @@ if ( isset( $plugin_page ) ) {
 	define( 'WP_IMPORTING', true );
 
 	/**
-	 * Whether to filter imported data through kses on import.
+	 * Filters whether to filter imported data through kses on import.
 	 *
 	 * Multisite uses this hook to filter all data through kses by default,
 	 * as a super administrator may be assisting an untrusted user.
diff --git a/wp-admin/customize.php b/wp-admin/customize.php
index 87fb749ad5..2f0bc87b86 100644
--- a/wp-admin/customize.php
+++ b/wp-admin/customize.php
@@ -116,7 +116,7 @@ wp_enqueue_script( 'customize-controls' );
 wp_enqueue_style( 'customize-controls' );
 
 /**
- * Enqueue Customizer control scripts.
+ * Fires when enqueuing Customizer control scripts.
  *
  * @since 3.4.0
  */
diff --git a/wp-admin/export.php b/wp-admin/export.php
index 7c59c9e6c0..e073a24f29 100644
--- a/wp-admin/export.php
+++ b/wp-admin/export.php
@@ -127,7 +127,7 @@ if ( isset( $_GET['download'] ) ) {
 require_once ABSPATH . 'wp-admin/admin-header.php';
 
 /**
- * Create the date options fields for exporting a given post type.
+ * Creates the date options fields for exporting a given post type.
  *
  * @global wpdb      $wpdb      WordPress database abstraction object.
  * @global WP_Locale $wp_locale WordPress date and time locale object.
diff --git a/wp-admin/index.php b/wp-admin/index.php
index 86164c62e4..7278cfbf37 100644
--- a/wp-admin/index.php
+++ b/wp-admin/index.php
@@ -186,7 +186,7 @@ if ( has_action( 'welcome_panel' ) && current_user_can( 'edit_theme_options' ) )
 		<a class="welcome-panel-close" href="<?php echo esc_url( admin_url( '?welcome=0' ) ); ?>" aria-label="<?php esc_attr_e( 'Dismiss the welcome panel' ); ?>"><?php _e( 'Dismiss' ); ?></a>
 		<?php
 		/**
-		 * Add content to the welcome panel on the admin dashboard.
+		 * Fires when adding content to the welcome panel on the admin dashboard.
 		 *
 		 * To remove the default welcome panel, use remove_action():
 		 *
diff --git a/wp-admin/link-parse-opml.php b/wp-admin/link-parse-opml.php
index c573db6f60..c0f02bd92d 100644
--- a/wp-admin/link-parse-opml.php
+++ b/wp-admin/link-parse-opml.php
@@ -16,7 +16,9 @@ if ( ! defined( 'ABSPATH' ) ) {
 global $opml;
 
 /**
- * XML callback function for the start of a new XML tag.
+ * Starts a new XML tag.
+ *
+ * Callback function for xml_set_element_handler().
  *
  * @since 0.71
  * @access private
@@ -60,7 +62,9 @@ function startElement( $parser, $tag_name, $attrs ) { // phpcs:ignore WordPress.
 }
 
 /**
- * XML callback function that is called at the end of a XML tag.
+ * Ends a new XML tag.
+ *
+ * Callback function for xml_set_element_handler().
  *
  * @since 0.71
  * @access private
diff --git a/wp-admin/my-sites.php b/wp-admin/my-sites.php
index aa8063c1d2..e395579ea2 100644
--- a/wp-admin/my-sites.php
+++ b/wp-admin/my-sites.php
@@ -96,7 +96,7 @@ else :
 	<ul class="my-sites striped">
 	<?php
 	/**
-	 * Enable the Global Settings section on the My Sites screen.
+	 * Filters the settings HTML markup in the Global Settings section on the My Sites screen.
 	 *
 	 * By default, the Global Settings section is hidden. Passing a non-empty
 	 * string to this filter will enable the section, and allow new settings
diff --git a/wp-admin/site-health.php b/wp-admin/site-health.php
index 8add5ce770..dac787748d 100644
--- a/wp-admin/site-health.php
+++ b/wp-admin/site-health.php
@@ -19,7 +19,7 @@ $tabs = array(
 );
 
 /**
- * An associative array of extra tabs for the Site Health navigation bar.
+ * Filters the extra tabs for the Site Health navigation bar.
  *
  * Add a custom page to the Site Health screen, based on a tab slug and label.
  * The label you provide will also be used as part of the site title.
@@ -198,7 +198,7 @@ require_once ABSPATH . 'wp-admin/admin-header.php';
 <?php
 if ( isset( $_GET['tab'] ) && ! empty( $_GET['tab'] ) ) {
 	/**
-	 * Output content of a custom Site Health tab.
+	 * Fires when outputting the content of a custom Site Health tab.
 	 *
 	 * This action fires right after the Site Health header, and users are still subject to
 	 * the capability checks for the Site Health page to view any custom tabs and their contents.
diff --git a/wp-admin/update-core.php b/wp-admin/update-core.php
index 138dfec756..6090229f4a 100644
--- a/wp-admin/update-core.php
+++ b/wp-admin/update-core.php
@@ -817,7 +817,7 @@ function list_translation_updates() {
 }
 
 /**
- * Upgrade WordPress core display.
+ * Upgrades WordPress core display.
  *
  * @since 2.7.0
  *
diff --git a/wp-includes/version.php b/wp-includes/version.php
index 0e2bd601ca..0fa056815d 100644
--- a/wp-includes/version.php
+++ b/wp-includes/version.php
@@ -16,7 +16,7 @@
  *
  * @global string $wp_version
  */
-$wp_version = '6.3-alpha-55916';
+$wp_version = '6.3-alpha-55917';
 
 /**
  * Holds the WordPress DB revision, increments when changes are made to the WordPress DB schema.