From b8750d5bb631db0f9e06481fa2d65edd9f01cfa8 Mon Sep 17 00:00:00 2001
From: Drew Jaynes <info@drewapicture.com>
Date: Mon, 7 Jul 2014 06:34:14 +0000
Subject: [PATCH] Add phpDoc blocks for two `WP_oEmbed` methods added in
 [28846].

Fixes #28284.

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


git-svn-id: http://core.svn.wordpress.org/trunk@28800 1a063a9b-81f0-0310-95a4-ce76da25c4cd
---
 wp-includes/class-oembed.php | 31 +++++++++++++++++++++++++++++++
 1 file changed, 31 insertions(+)

diff --git a/wp-includes/class-oembed.php b/wp-includes/class-oembed.php
index ff0b8853bd..d8b18a500a 100644
--- a/wp-includes/class-oembed.php
+++ b/wp-includes/class-oembed.php
@@ -198,6 +198,23 @@ class WP_oEmbed {
 		return $provider;
 	}
 
+	/**
+	 * Add an oEmbed provider just-in-time when wp_oembed_add_provider() is called
+	 * before the 'plugins_loaded' hook.
+	 *
+	 * The just-in-time addition is for the benefit of the 'oembed_providers' filter.
+	 *
+	 * @since 4.0.0
+	 * @static
+	 *
+	 * @see wp_oembed_add_provider()
+	 *
+	 * @param string $format   The format of URL that this provider can handle. You can use
+	 *                         asterisks as wildcards.
+	 * @param string $provider The URL to the oEmbed provider..
+	 * @param bool   $regex    Optional. Whether the $format parameter is in a regex format.
+	 *                         Default false.
+	 */
 	public static function _add_provider_early( $format, $provider, $regex = false ) {
 		if ( empty( self::$early_providers['add'] ) ) {
 			self::$early_providers['add'] = array();
@@ -206,6 +223,20 @@ class WP_oEmbed {
 		self::$early_providers['add'][ $format ] = array( $provider, $regex );
 	}
 
+	/**
+	 * Remove an oEmbed provider just-in-time when wp_oembed_remove_provider() is called
+	 * before the 'plugins_loaded' hook.
+	 *
+	 * The just-in-time removal is for the benefit of the 'oembed_providers' filter.
+	 *
+	 * @since 4.0.0
+	 * @static
+	 *
+	 * @see wp_oembed_remove_provider()
+	 *
+	 * @param string $format The format of URL that this provider can handle. You can use
+	 *                       asterisks as wildcards.
+	 */
 	public static function _remove_provider_early( $format ) {
 		if ( empty( self::$early_providers['remove'] ) ) {
 			self::$early_providers['remove'] = array();