diff --git src/wp-includes/embed-functions.php src/wp-includes/embed-functions.php
index ba8b08d..0a3bf18 100644
--- src/wp-includes/embed-functions.php
+++ src/wp-includes/embed-functions.php
@@ -74,9 +74,9 @@ function wp_embed_defaults( $url = '' ) {
 	 *
 	 * @since 2.9.0
 	 *
-	 * @param int    $width  Width of the embed in pixels.
-	 * @param int    $height Height of the embed in pixels.
-	 * @param string $url    The URL that should be embedded.
+	 * @param array  $size An array of embed width and height values
+	 *                     in pixels (in that order).
+	 * @param string $url  The URL that should be embedded.
 	 */
 	return apply_filters( 'embed_defaults', compact( 'width', 'height' ), $url );
 }