From 2b8290cd5b71e34904f6f0ce169d2ceaa07c3850 Mon Sep 17 00:00:00 2001
From: Christian Weiske <cweiske@cweiske.de>
Date: Sun, 7 Nov 2010 13:38:15 +0100
Subject: [PATCH] docblock for subscribe_to_feed

---
 functions.php | 14 ++++++++++++++
 1 file changed, 14 insertions(+)

diff --git a/functions.php b/functions.php
index 2373d5435..7f24b4d06 100644
--- a/functions.php
+++ b/functions.php
@@ -2940,6 +2940,20 @@
 		print "</rpc-reply>";
 	}
 
+	/**
+	 * Subscribes the user to the given feed
+	 *
+	 * @param resource $link       Database connection
+	 * @param string   $url        Feed URL to subscribe to
+	 * @param integer  $cat_id     Category ID the feed shall be added to
+	 * @param string   $auth_login (optional) Feed username
+	 * @param string   $auth_pass  (optional) Feed password
+	 *
+	 * @return integer Status code:
+	 *                 0 - OK, Feed already exists
+	 *                 1 - OK, Feed added
+	 *                 2 - Invalid URL
+	 */
 	function subscribe_to_feed($link, $url, $cat_id = 0, 
 			$auth_login = '', $auth_pass = '') {