[ticket/314] Fix function and method comments

includes/functions.php

@@ -128,9 +128,11 @@ function character_limit(&$title, $limit = 0)
 /**
 * Cut post text to given length
 *
-* @param $message string post text
-* @param $bbcode_uid string bbcode uid
-* @param $length int The desired length
+* @param string $message post text
+* @param string $bbcode_uid bbcode uid
+* @param int $length The desired length
+*
+* @return string Shortened message
 */
 function get_sub_taged_string($message, $bbcode_uid, $length)
 {

includes/modules_helper.php

@@ -49,6 +49,7 @@ class modules_helper
 	*
 	* @param bool $disallow_access Whether the array for disallowing access
 	*			should be filled
+	* @return array Array of forums the user is not allowed to access
 	*/
 	public function get_disallowed_forums($disallow_access)
 	{
@@ -123,7 +124,6 @@ class modules_helper
 	* Store selected forums
 	*
 	* @param string $key Key name
-	* @param int $module_id Module ID
 	*
 	* @return null
 	* @access public