owncloud / bookmarks

controller/lib/bookmarks.php

Doc Comments +11 added lines, -6 removed lines

@@ -85,7 +85,7 @@ 
 
 	/**
 	 * @brief Check if an URL is bookmarked
-	 * @param $url Url of a possible bookmark
+	 * @param string $url Url of a possible bookmark
 	 * @param $userId UserId
 	 * @param IDb $db Database Interface
 	 * @return boolean if the url is already bookmarked
@@ -187,6 +187,11 @@ 
 		return $bookmarks;
 	}
 
+	/**
+	 * @param string $sql
+	 * @param boolean $filterTagOnly
+	 * @param string $tagFilterConjunction
+	 */
 	private static function findBookmarksBuildFilter(&$sql, &$params, $filters, $filterTagOnly, $tagFilterConjunction, $CONFIG_DBTYPE) {
 		$tagOrSearch = false;
 		$connectWord = 'AND';
@@ -231,7 +236,7 @@ 
 	 * @brief Delete bookmark with specific id
 	 * @param $userId UserId
 	 * @param IDb $db Database Interface
-	 * @param $id Bookmark ID to delete
+	 * @param integer $id Bookmark ID to delete
 	 * @return boolean Success of operation
 	 */
 	public static function deleteUrl($userId, IDb $db, $id) {
@@ -371,7 +376,7 @@ 
 	 * @param array $tags Simple array of tags to qualify the bookmark (different tags are taken from values)
 	 * @param string $description A longer description about the bookmark
 	 * @param boolean $is_public True if the bookmark is publishable to not registered users
-	 * @return null
+	 * @return null|integer
 	 */
 	public static function editBookmark($userid, IDb $db, $id, $url, $title, $tags = array(), $description = '', $is_public = false) {
 
@@ -423,7 +428,7 @@ 
 	 * @param string $title Name of the bookmark
 	 * @param array $tags Simple array of tags to qualify the bookmark (different tags are taken from values)
 	 * @param string $description A longer description about the bookmark
-	 * @param boolean $public True if the bookmark is publishable to not registered users
+	 * @param boolean $is_public True if the bookmark is publishable to not registered users
 	 * @return int The id of the bookmark created
 	 */
 	public static function addBookmark($userid, IDb $db, $url, $title, $tags = array(), $description = '', $is_public = false) {
@@ -543,7 +548,7 @@ 
 
 	/**
 	 * @brief Load Url and receive Metadata (Title)
-	 * @param $url Url to load and analyze
+	 * @param string $url Url to load and analyze
 	 * @return array Metadata for url;
 	 * */
 	public static function getURLMetadata($url) {
@@ -587,7 +592,7 @@ 
 
 	/**
 	 * @brief Seperate Url String at comma charachter
-	 * @param $line String of Tags
+	 * @param string $line String of Tags
 	 * @return array Array of Tags
 	 * */
 	public static function analyzeTagRequest($line) {

controller/rest/bookmarkcontroller.php

Doc Comments -2 removed lines

@@ -155,7 +155,6 @@ 
 	  @NoAdminRequired
 	 * 
 	 * @param int $id
-	 * @param bool $is_public Description
 	 * @return \OCP\AppFramework\Http\JSONResponse
 	 */
 	public function legacyDeleteBookmark($id = -1) {
@@ -166,7 +165,6 @@ 
 	  @NoAdminRequired
 	 * 
 	 * @param int $id
-	 * @param bool $is_public Description
 	 * @return \OCP\AppFramework\Http\JSONResponse
 	 */
 	public function deleteBookmark($id = -1) {