From abbd18dbb7754a36e1abf64fc3140846c0e5fae8 Mon Sep 17 00:00:00 2001
From: Drew Jaynes <info@drewapicture.com>
Date: Sun, 22 May 2016 18:42:27 +0000
Subject: [PATCH] Docs: Standardize filter docs in wp-includes/embed.php to use
 third-person singular verbs per the inline documentation standards for PHP.

See #36913.

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


git-svn-id: http://core.svn.wordpress.org/trunk@37481 1a063a9b-81f0-0310-95a4-ce76da25c4cd
---
 wp-includes/embed.php   | 32 ++++++++++++++++----------------
 wp-includes/version.php |  2 +-
 2 files changed, 17 insertions(+), 17 deletions(-)

diff --git a/wp-includes/embed.php b/wp-includes/embed.php
index 7f69f2776c..339da515ea 100644
--- a/wp-includes/embed.php
+++ b/wp-includes/embed.php
@@ -70,7 +70,7 @@ function wp_embed_defaults( $url = '' ) {
 	$height = min( ceil( $width * 1.5 ), 1000 );
 
 	/**
-	 * Filter the default array of embed dimensions.
+	 * Filters the default array of embed dimensions.
 	 *
 	 * @since 2.9.0
 	 *
@@ -161,7 +161,7 @@ function wp_oembed_remove_provider( $format ) {
  */
 function wp_maybe_load_embeds() {
 	/**
-	 * Filter whether to load the default embed handlers.
+	 * Filters whether to load the default embed handlers.
 	 *
 	 * Returning a falsey value will prevent loading the default embed handlers.
 	 *
@@ -178,7 +178,7 @@ function wp_maybe_load_embeds() {
 	wp_embed_register_handler( 'googlevideo', '#http://video\.google\.([A-Za-z.]{2,5})/videoplay\?docid=([\d-]+)(.*?)#i', 'wp_embed_handler_googlevideo' );
 
 	/**
-	 * Filter the audio embed handler callback.
+	 * Filters the audio embed handler callback.
 	 *
 	 * @since 3.6.0
 	 *
@@ -187,7 +187,7 @@ function wp_maybe_load_embeds() {
 	wp_embed_register_handler( 'audio', '#^https?://.+?\.(' . join( '|', wp_get_audio_extensions() ) . ')$#i', apply_filters( 'wp_audio_embed_handler', 'wp_embed_handler_audio' ), 9999 );
 
 	/**
-	 * Filter the video embed handler callback.
+	 * Filters the video embed handler callback.
 	 *
 	 * @since 3.6.0
 	 *
@@ -220,7 +220,7 @@ function wp_embed_handler_googlevideo( $matches, $attr, $url, $rawattr ) {
 	}
 
 	/**
-	 * Filter the Google Video embed output.
+	 * Filters the Google Video embed output.
 	 *
 	 * @since 2.9.0
 	 *
@@ -254,7 +254,7 @@ function wp_embed_handler_youtube( $matches, $attr, $url, $rawattr ) {
 	$embed = $wp_embed->autoembed( "https://youtube.com/watch?v={$matches[2]}" );
 
 	/**
-	 * Filter the YoutTube embed output.
+	 * Filters the YoutTube embed output.
 	 *
 	 * @since 4.0.0
 	 *
@@ -283,7 +283,7 @@ function wp_embed_handler_audio( $matches, $attr, $url, $rawattr ) {
 	$audio = sprintf( '[audio src="%s" /]', esc_url( $url ) );
 
 	/**
-	 * Filter the audio embed output.
+	 * Filters the audio embed output.
 	 *
 	 * @since 3.6.0
 	 *
@@ -315,7 +315,7 @@ function wp_embed_handler_video( $matches, $attr, $url, $rawattr ) {
 	$video = sprintf( '[video %s src="%s" /]', $dimensions, esc_url( $url ) );
 
 	/**
-	 * Filter the video embed output.
+	 * Filters the video embed output.
 	 *
 	 * @since 3.6.0
 	 *
@@ -354,7 +354,7 @@ function wp_oembed_add_discovery_links() {
 	}
 
 	/**
-	 * Filter the oEmbed discovery links HTML.
+	 * Filters the oEmbed discovery links HTML.
 	 *
 	 * @since 4.4.0
 	 *
@@ -395,7 +395,7 @@ function get_post_embed_url( $post = null ) {
 	}
 
 	/**
-	 * Filter the URL to embed a specific post.
+	 * Filters the URL to embed a specific post.
 	 *
 	 * @since 4.4.0
 	 *
@@ -431,7 +431,7 @@ function get_oembed_endpoint_url( $permalink = '', $format = 'json' ) {
 	}
 
 	/**
-	 * Filter the oEmbed endpoint URL.
+	 * Filters the oEmbed endpoint URL.
 	 *
 	 * @since 4.4.0
 	 *
@@ -501,7 +501,7 @@ JS;
 	);
 
 	/**
-	 * Filter the embed HTML output for a given post.
+	 * Filters the embed HTML output for a given post.
 	 *
 	 * @since 4.4.0
 	 *
@@ -534,7 +534,7 @@ function get_oembed_response_data( $post, $width ) {
 	}
 
 	/**
-	 * Filter the allowed minimum and maximum widths for the oEmbed response.
+	 * Filters the allowed minimum and maximum widths for the oEmbed response.
 	 *
 	 * @since 4.4.0
 	 *
@@ -571,7 +571,7 @@ function get_oembed_response_data( $post, $width ) {
 	}
 
 	/**
-	 * Filter the oEmbed response data.
+	 * Filters the oEmbed response data.
 	 *
 	 * @since 4.4.0
 	 *
@@ -839,7 +839,7 @@ function the_excerpt_embed() {
 	$output = get_the_excerpt();
 
 	/**
-	 * Filter the post excerpt for the embed template.
+	 * Filters the post excerpt for the embed template.
 	 *
 	 * @since 4.4.0
 	 *
@@ -1070,7 +1070,7 @@ function the_embed_site_title() {
 	$site_title = '<div class="wp-embed-site-title">' . $site_title . '</div>';
 
 	/**
-	 * Filter the site title HTML in the embed footer.
+	 * Filters the site title HTML in the embed footer.
 	 *
 	 * @since 4.4.0
 	 *
diff --git a/wp-includes/version.php b/wp-includes/version.php
index 77532b0d81..c85eab220b 100644
--- a/wp-includes/version.php
+++ b/wp-includes/version.php
@@ -4,7 +4,7 @@
  *
  * @global string $wp_version
  */
-$wp_version = '4.6-alpha-37512';
+$wp_version = '4.6-alpha-37513';
 
 /**
  * Holds the WordPress DB revision, increments when changes are made to the WordPress DB schema.