seblucas / cops

author.php

Doc Comments +6 added lines

@@ -62,6 +62,9 @@ 
         return self::getEntryArray (self::SQL_AUTHORS_BY_FIRST_LETTER, array ($letter . "%"));
     }
 
+    /**
+     * @param string $query
+     */
     public static function getAuthorsForSearch($query) {
         return self::getEntryArray (self::SQL_AUTHORS_FOR_SEARCH, array ($query . "%", $query . "%"));
     }
@@ -70,6 +73,9 @@ 
         return self::getEntryArray (self::SQL_ALL_AUTHORS, array ());
     }
 
+    /**
+     * @param string $query
+     */
     public static function getEntryArray ($query, $params) {
         return Base::getEntryArrayWithBookNumber ($query, self::AUTHOR_COLUMNS, $params, "Author");
     }

data.php

Doc Comments +10 added lines

@@ -139,6 +139,9 @@ 
         return new Link ($href, $this->getMimeType (), Link::OPDS_ACQUISITION_TYPE, $title);
     }
 
+    /**
+     * @param Book $book
+     */
     public static function getDataByBook ($book) {
         $out = array ();
         $result = parent::getDb ()->prepare('select id, format, name
@@ -152,6 +155,9 @@ 
         return $out;
     }
 
+    /**
+     * @param string $urlParam
+     */
     public static function handleThumbnailLink ($urlParam, $height) {
         global $config;
 
@@ -171,6 +177,10 @@ 
         return $urlParam;
     }
 
+    /**
+     * @param string $type
+     * @param string $filename
+     */
     public static function getLink ($book, $type, $mime, $rel, $filename, $idData, $title = NULL, $height = NULL)
     {
         global $config;

rating.php

Doc Comments +3 added lines

@@ -38,6 +38,9 @@
         return self::getEntryArray (self::SQL_ALL_RATINGS, array ());
     }
 
+    /**
+     * @param string $query
+     */
     public static function getEntryArray ($query, $params) {
         list (, $result) = parent::executeQuery ($query, self::RATING_COLUMNS, "", $params, -1);
         $entryArray = array();

tag.php

Doc Comments +3 added lines

@@ -47,6 +47,9 @@
         return Base::getEntryArrayWithBookNumber (self::SQL_ALL_TAGS, self::TAG_COLUMNS, array (), "Tag");
     }
 
+    /**
+     * @param integer $numberPerPage
+     */
     public static function getAllTagsByQuery($query, $n, $database = NULL, $numberPerPage = NULL) {
         $columns  = "tags.id as id, tags.name as name, (select count(*) from books_tags_link where tags.id = tag) as count";
         $sql = 'select {0} from tags where upper (tags.name) like ? {1} order by tags.name';

test/OPDSTest.php

Doc Comments +6 added lines

@@ -26,6 +26,9 @@ 
         unlink (TEST_FEED);
     }
 
+    /**
+     * @param string $relax
+     */
     function jingValidateSchema($feed, $relax = OPDS_RELAX_NG) {
         $path = "";
         if (strtoupper(substr(PHP_OS, 0, 3)) === 'WIN') {
@@ -57,6 +60,9 @@ 
             return true;
     }
 
+    /**
+     * @param string $feed
+     */
     function opdsCompleteValidation ($feed) {
         return $this->jingValidateSchema($feed) && $this->opdsValidator($feed);
     }

test/Sauce.php

Doc Comments +4 added lines

@@ -189,6 +189,10 @@
         $this->assertEquals (14, count($filtered));
     }
 
+    /**
+     * @param string $src
+     * @param string $out
+     */
     public function normalSearch ($src, $out)
     {
         $driver = $this;

transliteration.php

Doc Comments +1 added lines, -1 removed lines

@@ -163,7 +163,7 @@
 /**
  * Replaces a Unicode character using the transliteration database.
  *
- * @param $ord
+ * @param integer $ord
  *   An ordinal Unicode character code.
  * @param $unknown
  *   Replacement string for characters that do not have a suitable ASCII

book.php

Doc Comments +27 added lines

@@ -294,6 +294,11 @@ 
         }
     }
 
+    /**
+     * @param string $format
+     *
+     * @return boolean
+     */
     public function getDataFormat ($format) {
         $reduced = array_filter ($this->getDatas (), function ($data) use ($format) {
             return $data->format == $format;
@@ -301,6 +306,10 @@ 
         return reset ($reduced);
     }
 
+    /**
+     * @param string $extension
+     * @param integer $idData
+     */
     public function getFilePath ($extension, $idData = NULL, $relative = false)
     {
         if ($extension == "jpg")
@@ -360,6 +369,9 @@ 
         }
     }
 
+    /**
+     * @param string $outputfile
+     */
     public function getThumbnail ($width, $height, $outputfile = NULL) {
         if (is_null ($width) && is_null ($height)) {
             return false;
@@ -433,6 +445,10 @@ 
             $this->getLinkArray (), $this);
     }
 
+    /**
+     * @param integer $database
+     * @param integer $virtualLib
+     */
     public static function getBookCount($database = NULL, $virtualLib = NULL) {
         return parent::executeFilteredQuerySingle('select count(*) from ({0}) as filter', $database, $virtualLib);
     }
@@ -498,6 +514,9 @@ 
         return NULL;
     }
 
+    /**
+     * @param integer $dataId
+     */
     public static function getBookByDataId($dataId) {
         $result = parent::getDb ()->prepare('select ' . self::BOOK_COLUMNS . ', data.name, data.format
 from data, books ' . self::SQL_BOOKS_LEFT_JOIN . '
@@ -514,6 +533,11 @@ 
         return NULL;
     }
 
+    /**
+     * @param integer $database
+     * @param integer $virtualLib
+     * @param integer $numberPerPage
+     */
     public static function getBooksByQuery($query, $n, $database = NULL, $virtualLib = NULL, $numberPerPage = NULL) {
         $i = 0;
         $critArray = array ();
@@ -558,6 +582,9 @@ 
         return $entryArray;
     }
 
+    /**
+     * @param integer $numberPerPage
+     */
     public static function getBooksByStartingLetter($letter, $n, $database = NULL, $virtualLib = NULL, $numberPerPage = NULL) {
         return self::getEntryArray (self::SQL_BOOKS_BY_FIRST_LETTER, array ($letter . "%"), $n, $database, $virtualLib, $numberPerPage);
     }

virtuallib.php

Doc Comments +3 added lines, -3 removed lines

@@ -43,7 +43,7 @@ 
 	/**
 	 * Includes the booke filter (see $config['cops_books_filter'])
 	 * @param Filter $filter
-	 * @return string
+	 * @return Filter
 	 */
 	private static function includeBookFilter($filter) {
 		$bookFilter = getURLParam ("tag", NULL);
@@ -206,7 +206,7 @@ 
 	 * 
 	 * Some attributes can be used in plural (e.g. languages) and singular (e.g. language). This function appends a missing s and puts everything to lower case
 	 * @param string $attr the attribute, like it was used in calibre
-	 * @return the normalized attribute name
+	 * @return string normalized attribute name
 	 */
 	public static function normalizeAttribute($attr) {
 		$attr = strtolower($attr);
@@ -414,7 +414,7 @@ 
 
 	/**
 	 * Constructor that combines multiple filters to one filter
-	 * @param array $parts An array of Filter objects
+	 * @param Filter[] $parts An array of Filter objects
 	 * @param string $op The operator for combining. Either "and" or "or" (case insensitive).
 	 */
 	public function __construct($parts, $op = "and") {