From d60cbb399ea0a0f2161dfee071fd57b4ce4c3575 Mon Sep 17 00:00:00 2001
From: Sergey Biryukov <sergeybiryukov@git.wordpress.org>
Date: Fri, 13 Sep 2013 09:01:20 +0000
Subject: [PATCH] Inline documentation for hooks in wp-includes/shortcodes.php.

props natejacobs.
see #25229.

git-svn-id: https://develop.svn.wordpress.org/trunk@25423 602fd350-edb4-49c9-b593-d223f7449a82
---
 src/wp-includes/shortcodes.php | 13 ++++++++++++-
 1 file changed, 12 insertions(+), 1 deletion(-)

diff --git a/src/wp-includes/shortcodes.php b/src/wp-includes/shortcodes.php
index a40959491b..147f9c5017 100644
--- a/src/wp-includes/shortcodes.php
+++ b/src/wp-includes/shortcodes.php
@@ -338,7 +338,18 @@ function shortcode_atts( $pairs, $atts, $shortcode = '' ) {
 		else
 			$out[$name] = $default;
 	}
-
+	/**
+	 * Filter a shortcode's default attributes.
+	 *
+	 * If the third parameter of the shortcode_atts() function is present then this filter is available. 
+	 * The third parameter, $shortcode, is the name of the shortcode.
+	 *
+	 * @since 3.6.0
+	 *
+	 * @param array $out The output array of shortcode attributes.
+	 * @param array $pairs The supported attributes and their defaults.
+	 * @param array $atts The user defined shortcode attributes.
+	 */
 	if ( $shortcode )
 		$out = apply_filters( "shortcode_atts_{$shortcode}", $out, $pairs, $atts );