Docs: Use third-person singular verbs for function descriptions in WP_Embed class, per the documentation standards.

See #54729.


git-svn-id: https://develop.svn.wordpress.org/trunk@53046 602fd350-edb4-49c9-b593-d223f7449a82

Author: audrasjb

src/wp-includes/class-wp-embed.php

@@ -47,16 +47,16 @@ public function __construct() {
 	}
 
 	/**
-	 * Process the [embed] shortcode.
+	 * Processes the [embed] shortcode.
 	 *
 	 * Since the [embed] shortcode needs to be run earlier than other shortcodes,
 	 * this function removes all existing shortcodes, registers the [embed] shortcode,
 	 * calls do_shortcode(), and then re-registers the old shortcodes.
 	 *
 	 * @global array $shortcode_tags
 	 *
-	 * @param string $content Content to parse
-	 * @return string Content with shortcode parsed
+	 * @param string $content Content to parse.
+	 * @return string Content with shortcode parsed.
 	 */
 	public function run_shortcode( $content ) {
 		global $shortcode_tags;
@@ -376,7 +376,7 @@ public function shortcode( $attr, $url = '' ) {
 	}
 
 	/**
-	 * Delete all oEmbed caches. Unused by core as of 4.0.0.
+	 * Deletes all oEmbed caches. Unused by core as of 4.0.0.
 	 *
 	 * @param int $post_ID Post ID to delete the caches for.
 	 */
@@ -491,7 +491,7 @@ public function maybe_make_link( $url ) {
 	}
 
 	/**
-	 * Find the oEmbed cache post ID for a given cache key.
+	 * Finds the oEmbed cache post ID for a given cache key.
 	 *
 	 * @since 4.9.0
 	 *