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

@@ -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
  *

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.

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
  */

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.

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():
 		 *

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

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

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.

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
  *

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.