Inline documentation cleanup for 4.0 audit.

Added in [28652]:
* Various phpDoc improvements for `wp_embed_handler_youtube()`
* Adds `@see` reference to `wp_embed_handler_youtube()` in 'wp_embed_handler_youtube' filter docs

Added in [29029]:
* s/post_id/post ID in `@return` description for `attachment_url_to_postid()`

See #28885.


git-svn-id: https://develop.svn.wordpress.org/trunk@29164 602fd350-edb4-49c9-b593-d223f7449a82
This commit is contained in:
Drew Jaynes (DrewAPicture) 2014-07-14 01:06:58 +00:00
parent 551f829c55
commit a752c42b05
1 changed files with 12 additions and 6 deletions

View File

@ -2281,14 +2281,17 @@ function wp_embed_handler_googlevideo( $matches, $attr, $url, $rawattr ) {
}
/**
* The YouTube embed handler callback. Catches URLs that can be parsed but aren't supported by oEmbed.
* YouTube embed handler callback.
*
* Catches URLs that can be parsed but aren't supported by oEmbed.
*
* @since 4.0.0
*
* @param array $matches The regex matches from the provided regex when calling {@link wp_embed_register_handler()}.
* @param array $attr Embed attributes.
* @param string $url The original URL that was matched by the regex.
* @param array $rawattr The original unmodified attributes.
* @param array $matches The regex matches from the provided regex when calling
* {@link wp_embed_register_handler()}.
* @param array $attr Embed attributes.
* @param string $url The original URL that was matched by the regex.
* @param array $rawattr The original unmodified attributes.
* @return string The embed HTML.
*/
function wp_embed_handler_youtube( $matches, $attr, $url, $rawattr ) {
@ -2299,6 +2302,8 @@ function wp_embed_handler_youtube( $matches, $attr, $url, $rawattr ) {
*
* @since 4.0.0
*
* @see wp_embed_handler_youtube()
*
* @param string $embed YouTube embed output.
* @param array $attr An array of embed attributes.
* @param string $url The original URL that was matched by the regex.
@ -3232,8 +3237,9 @@ function wp_maybe_generate_attachment_metadata( $attachment ) {
* @since 4.0.0
*
* @global wpdb $wpdb WordPress database access abstraction object.
*
* @param string $url The URL to resolve.
* @return int The found post_id.
* @return int The found post ID.
*/
function attachment_url_to_postid( $url ) {
global $wpdb;