From a77be61eb6a732ae533261e02f8fc7d489d7dd25 Mon Sep 17 00:00:00 2001
From: Andrew Nacin <nacin@git.wordpress.org>
Date: Mon, 22 Apr 2013 20:24:41 +0000
Subject: [PATCH] Document that fetch_feed() can accept multiple URLs, thus
 leveraging SimplePie's multifeed feature. props JustinSainton, fixes #22140.

git-svn-id: https://develop.svn.wordpress.org/trunk@24054 602fd350-edb4-49c9-b593-d223f7449a82
---
 wp-includes/feed.php | 13 ++++++++-----
 1 file changed, 8 insertions(+), 5 deletions(-)

diff --git a/wp-includes/feed.php b/wp-includes/feed.php
index 76b9bbb2cd..b32b06a322 100644
--- a/wp-includes/feed.php
+++ b/wp-includes/feed.php
@@ -520,11 +520,14 @@ function feed_content_type( $type = '' ) {
  *
  * @since 2.8
  *
- * @param string $url URL to retrieve feed
+ * @param mixed $url URL of feed to retrieve. If an array of URLs, the feeds are merged
+ * using SimplePie's multifeed feature.
+ * See also {@link ​http://simplepie.org/wiki/faq/typical_multifeed_gotchas}
+ *
  * @return WP_Error|SimplePie WP_Error object on failure or SimplePie object on success
  */
-function fetch_feed($url) {
-	require_once (ABSPATH . WPINC . '/class-feed.php');
+function fetch_feed( $url ) {
+	require_once ( ABSPATH . WPINC . '/class-feed.php' );
 
 	$feed = new SimplePie();
 
@@ -536,14 +539,14 @@ function fetch_feed($url) {
 	$feed->set_cache_class( 'WP_Feed_Cache' );
 	$feed->set_file_class( 'WP_SimplePie_File' );
 
-	$feed->set_feed_url($url);
+	$feed->set_feed_url( $url );
 	$feed->set_cache_duration( apply_filters( 'wp_feed_cache_transient_lifetime', 12 * HOUR_IN_SECONDS, $url ) );
 	do_action_ref_array( 'wp_feed_options', array( &$feed, $url ) );
 	$feed->init();
 	$feed->handle_content_type();
 
 	if ( $feed->error() )
-		return new WP_Error('simplepie-error', $feed->error());
+		return new WP_Error( 'simplepie-error', $feed->error() );
 
 	return $feed;
 }