ErnadoO / mod-phpbb-directory

root/includes/acp/acp_directory.php

Doc Comments +10 added lines

@@ -1521,6 +1521,9 @@ 
 		adm_page_footer();
 	}
 
+	/**
+	 * @return string
+	 */
 	function move_cat_by($dir_cat_row, $action = 'move_up', $steps = 1)
 	{
 		global $db;
@@ -1790,6 +1793,9 @@ 
 		return $errors;
 	}
 
+	/**
+	 * @param integer $to_id
+	 */
 	function move_cat_content($from_id, $to_id)
 	{
 		global $db;
@@ -1972,6 +1978,10 @@ 
 	return;
 }
 
+/**
+ * @param integer $start
+ * @param integer $stop
+ */
 function sync_dir_links($start, $stop)
 {
 	global $db;

root/includes/mods/directory/functions.php

Doc Comments +15 added lines, -19 removed lines

@@ -55,7 +55,6 @@ 
 	* Edit a link of the db
 	*
 	* @param array $data contains all datas to edit in db
-	* @param int $u is link's id, for WHERE clause
 	*/
 	function edit($data, $url_id, $need_approval)
 	{
@@ -95,7 +94,6 @@ 
 	/**
 	* Del a link of the db
 	*
-	* @param int $u is link's id, for WHERE clause
 	*/
 	function del($url_id, $cat_id, $cron = false)
 	{
@@ -168,7 +166,6 @@ 
 	/**
 	* Increments link view counter
 	*
-	* @param int $u is link's id, for WHERE clause
 	*/
 	function view($url_id)
 	{
@@ -198,7 +195,7 @@ 
 	*
 	* @param string $url
 	*
-	* @return true if ok, else false.
+	* @return boolean if ok, else false.
 	*/
 	function checkurl($url)
 	{
@@ -242,7 +239,7 @@ 
 	*
 	* @param string $url to clean
 	*
-	* @return the correct string.
+	* @return string correct string.
 	*/
 	function clean_url($url)
 	{
@@ -260,7 +257,7 @@ 
 	 *
 	 * @param array $data link's data from db
 	 *
-	 * @return flag image.
+	 * @return string image.
 	 */
 	function display_flag($data)
 	{
@@ -319,7 +316,7 @@ 
 	*
 	* @param array $data link's data from db
 	*
-	* @return the html code.
+	* @return null|string html code.
 	*/
 	function display_vote($data, $votes_status)
 	{
@@ -392,7 +389,7 @@ 
 	*
 	* @param array $data link's data from db
 	*
-	* @return pr image, false or 'n/a'.
+	* @return string|false image, false or 'n/a'.
 	*/
 	function display_pagerank($data)
 	{
@@ -427,9 +424,7 @@ 
 	* Display and resize a banner
 	*
 	* @param array $data link's data from db
-	* @param bool $have_banner
-	*
-	* @return banner image.
+	* @return string
 	*/
 	function display_bann($data)
 	{
@@ -465,9 +460,9 @@ 
 	* Display number of comments and link for posting
 	*
 	* @param int $u is link_id from db
-	* @param int $nb_comments si number of comments for this link
+	* @param int $nb_comment si number of comments for this link
 	*
-	* @return html code (counter + link).
+	* @return null|string code (counter + link).
 	*/
 	function display_comm($u, $nb_comment, $comments_status)
 	{
@@ -598,7 +593,6 @@ 
 	/**
 	 * Send a email to user who want be notify of a new publication link
 	 *
-	 * @param array $data link's data from db
 	 */
 	function notify_member($site)
 	{
@@ -661,7 +655,7 @@ 
 	*
 	* @param string $url is link's url
 	*
-	* @return the thumb url
+	* @return string thumb url
 	*/
 	function thumb_process($url)
 	{
@@ -794,7 +788,7 @@ 
 	*
 	* @param string $banner is banner's remote url
 	*
-	* @return false if error, true for ok
+	* @return false|string if error, true for ok
 	*/
 	function banner_remote($banner, &$error)
 	{
@@ -865,7 +859,7 @@ 
 	* @param string $destination path to banner directory
 	* @param string $file is file's name
 	*
-	* @return true if delete success, else false
+	* @return boolean if delete success, else false
 	*/
 	function banner_delete($destination, $file)
 	{
@@ -1423,10 +1417,9 @@ 
 /**
  * List flags
  *
- * @param string $dir is flag directory path
  * @param $value selected flag
  *
- * @return html code
+ * @return string code
  */
 function get_dir_flag_list($value)
 {
@@ -1638,6 +1631,9 @@ 
 	}
 }
 
+/**
+ * @param boolean $optional
+ */
 function validate_link_back($remote_url, $optional, $cron = false)
 {
 	global $config;