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

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

Props costdev.
See #57840.




git-svn-id: https://develop.svn.wordpress.org/trunk@55918 602fd350-edb4-49c9-b593-d223f7449a82
---
 src/wp-comments-post.php | 2 +-
 src/wp-login.php         | 6 +++---
 src/wp-signup.php        | 2 +-
 src/xmlrpc.php           | 2 +-
 4 files changed, 6 insertions(+), 6 deletions(-)

diff --git a/src/wp-comments-post.php b/src/wp-comments-post.php
index e9a758dcfd..6042ac1e2f 100644
--- a/src/wp-comments-post.php
+++ b/src/wp-comments-post.php
@@ -43,7 +43,7 @@ $user            = wp_get_current_user();
 $cookies_consent = ( isset( $_POST['wp-comment-cookies-consent'] ) );
 
 /**
- * Perform other actions when comment cookies are set.
+ * Fires after comment cookies are set.
  *
  * @since 3.4.0
  * @since 4.9.6 The `$cookies_consent` parameter was added.
diff --git a/src/wp-login.php b/src/wp-login.php
index ccd7a91f78..e53eedb2c4 100644
--- a/src/wp-login.php
+++ b/src/wp-login.php
@@ -23,7 +23,7 @@ if ( force_ssl_admin() && ! is_ssl() ) {
 }
 
 /**
- * Output the login page header.
+ * Outputs the login page header.
  *
  * @since 2.1.0
  *
@@ -107,7 +107,7 @@ function login_header( $title = 'Log In', $message = '', $wp_error = null ) {
 	}
 
 	/**
-	 * Enqueue scripts and styles for the login page.
+	 * Enqueues scripts and styles for the login page.
 	 *
 	 * @since 3.1.0
 	 */
@@ -294,7 +294,7 @@ function login_footer( $input_id = '' ) {
 				)
 			);
 			/**
-			 * Filter the "Go to site" link displayed in the login page footer.
+			 * Filters the "Go to site" link displayed in the login page footer.
 			 *
 			 * @since 5.7.0
 			 *
diff --git a/src/wp-signup.php b/src/wp-signup.php
index 19cf50552f..8b40dec9e5 100644
--- a/src/wp-signup.php
+++ b/src/wp-signup.php
@@ -399,7 +399,7 @@ function signup_another_blog( $blogname = '', $blog_title = '', $errors = '' ) {
 		<input type="hidden" name="stage" value="gimmeanotherblog" />
 		<?php
 		/**
-		 * Hidden sign-up form fields output when creating another site or user.
+		 * Fires when hidden sign-up form fields output when creating another site or user.
 		 *
 		 * @since MU (3.0.0)
 		 *
diff --git a/src/xmlrpc.php b/src/xmlrpc.php
index 55800daaf4..ac0f191792 100644
--- a/src/xmlrpc.php
+++ b/src/xmlrpc.php
@@ -46,7 +46,7 @@ if ( isset( $_GET['rsd'] ) ) { // https://cyber.harvard.edu/blogs/gems/tech/rsd.
 			<api name="Blogger" blogID="1" preferred="false" apiLink="<?php echo site_url( 'xmlrpc.php', 'rpc' ); ?>" />
 			<?php
 			/**
-			 * Adds additional APIs to the Really Simple Discovery (RSD) endpoint.
+			 * Fires when adding APIs to the Really Simple Discovery (RSD) endpoint.
 			 *
 			 * @link https://cyber.harvard.edu/blogs/gems/tech/rsd.html
 			 *