[ticket/16955] Clean up feed classes

PHPBB3-16955

phpBB/phpbb/feed/base.php

@@ -329,9 +329,9 @@ abstract class base implements feed_interface
 	}
 
 	/**
-	 * Returns the SQL query used to retrieve the posts of the feed.
+	 * Sets the SQL query used to retrieve the posts of the feed and returns success state
 	 *
-	 * @return string SQL SELECT query
+	 * @return bool True of SQL query was set, false if not
 	 */
 	protected abstract function get_sql();
 }

phpBB/phpbb/feed/controller/feed.php

@@ -298,7 +298,7 @@ class feed
 	 *
 	 * @return Response
 	 *
-	 * @throws exception\feed_exception
+	 * @throws \phpbb\feed\exception\feed_exception
 	 */
 	protected function send_feed_do(feed_interface $feed)
 	{

phpBB/phpbb/feed/feed_interface.php

@@ -52,7 +52,7 @@ interface feed_interface
 	/**
 	 * Get the next post in the feed
 	 *
-	 * @return array
+	 * @return array|false Item array or false if no next item exists
 	 */
 	public function get_item();