From c79cb5b43f85fd083958a0b4f73de424ef58fe3e Mon Sep 17 00:00:00 2001
From: Drew Jaynes <info@drewapicture.com>
Date: Tue, 8 Oct 2013 00:22:09 +0000
Subject: [PATCH] Inline documentation for hooks in wp-includes/category.php.

Props ben.moody
Fixes #25503.

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


git-svn-id: http://core.svn.wordpress.org/trunk@25637 1a063a9b-81f0-0310-95a4-ce76da25c4cd
---
 wp-includes/category.php | 21 +++++++++++++++++++--
 1 file changed, 19 insertions(+), 2 deletions(-)

diff --git a/wp-includes/category.php b/wp-includes/category.php
index 1bddce3ada..9fe86efcb9 100644
--- a/wp-includes/category.php
+++ b/wp-includes/category.php
@@ -40,7 +40,16 @@ function get_categories( $args = '' ) {
 	$defaults = array( 'taxonomy' => 'category' );
 	$args = wp_parse_args( $args, $defaults );
 
-	$taxonomy = apply_filters( 'get_categories_taxonomy', $args['taxonomy'], $args );
+	$taxonomy = $args['taxonomy'];
+	/**
+	 * Filter the taxonomy used to retrieve terms when calling get_categories().
+	 *
+	 * @since 2.7.0
+	 *
+	 * @param string $taxonomy Taxonomy to retrieve terms from.
+	 * @param array  $args     An array of arguments. @see get_terms()
+	 */
+	$taxonomy = apply_filters( 'get_categories_taxonomy', $taxonomy, $args );
 
 	// Back compat
 	if ( isset($args['type']) && 'link' == $args['type'] ) {
@@ -262,7 +271,15 @@ function get_tags( $args = '' ) {
 		$return = array();
 		return $return;
 	}
-
+	
+	/**
+	 * Filter the array of term objects returned for the 'post_tag' taxonomy.
+	 *
+	 * @since 2.3.0
+	 *
+	 * @param array $tags Array of 'post_tag' term objects.
+	 * @param array $args An array of arguments. @see get_terms()
+	 */
 	$tags = apply_filters( 'get_tags', $tags, $args );
 	return $tags;
 }