From 6d1558e46152396ff863bd113dea46eb47a4e0e8 Mon Sep 17 00:00:00 2001
From: Drew Jaynes <drewapicture@git.wordpress.org>
Date: Tue, 8 Oct 2013 00:21:47 +0000
Subject: [PATCH] Inline documentation for hooks in wp-includes/category.php.

Props ben.moody
Fixes #25503.


git-svn-id: https://develop.svn.wordpress.org/trunk@25724 602fd350-edb4-49c9-b593-d223f7449a82
---
 src/wp-includes/category.php | 21 +++++++++++++++++++--
 1 file changed, 19 insertions(+), 2 deletions(-)

diff --git a/src/wp-includes/category.php b/src/wp-includes/category.php
index 1bddce3ada..9fe86efcb9 100644
--- a/src/wp-includes/category.php
+++ b/src/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;
 }