Fix: DocBlock

src/Faker/Calculator/Luhn.php

@@ -35,7 +35,7 @@ class Luhn
 
     /**
      * @param $partialNumber
-     * @return string
+     * @return string|int
      */
     public static function computeCheckDigit($partialNumber)
     {

src/Faker/Provider/Barcode.php

@@ -39,7 +39,7 @@ class Barcode extends Base
      * @param  string           $input ISBN without check-digit
      * @throws \LengthException When wrong input length passed
      *
-     * @return integer Check digit
+     * @return integer|string Check digit
      */
     protected static function isbnChecksum($input)
     {

src/Faker/Provider/Base.php

@@ -173,9 +173,9 @@ class Base
     /**
      * Returns randomly ordered subsequence of $count elements from a provided array
      *
-     * @param  array            $array           Array to take elements from. Defaults to a-c
-     * @param  integer          $count           Number of elements to take.
-     * @param  boolean          $allowDuplicates Allow elements to be picked several times. Defaults to false
+     * @param  array|\Traversable $array           Array to take elements from. Defaults to a-c
+     * @param  integer            $count           Number of elements to take.
+     * @param  boolean            $allowDuplicates Allow elements to be picked several times. Defaults to false
      * @throws \LengthException When requesting more elements than provided
      *
      * @return array New array with $count elements from $array
@@ -190,6 +190,7 @@ class Base
             }
         }
 
+        /** @var array $arr */
         $arr = count($traversables) ? $traversables : $array;
 
         $allKeys = array_keys($arr);
@@ -223,7 +224,7 @@ class Base
     /**
      * Returns a random element from a passed array
      *
-     * @param  array $array
+     * @param  array|\Traversable $array
      * @return mixed
      */
     public static function randomElement($array = ['a', 'b', 'c'])

src/Faker/Provider/PhoneNumber.php

@@ -32,7 +32,7 @@ class PhoneNumber extends Base
      * @link http://en.wikipedia.org/wiki/International_Mobile_Station_Equipment_Identity
      * @link http://imei-number.com/imei-validation-check/
      * @example '720084494799532'
-     * @return int $imei
+     * @return string $imei
      */
     public function imei()
     {

src/Faker/Provider/pl_PL/Company.php

@@ -56,7 +56,7 @@ class Company extends \Faker\Provider\Company
     /**
      * Register of the National Economy, local entity number
      * @link http://pl.wikipedia.org/wiki/REGON
-     * @return 14 digit number
+     * @return string 14 digit number
      */
     public static function regonLocal()
     {

src/Faker/Provider/pl_PL/Person.php

@@ -83,7 +83,7 @@ class Person extends \Faker\Provider\Person
      *
      * Unisex academic degree
      *
-     * @var string
+     * @var array<string>
      */
     protected static $title = ['mgr','inż.', 'dr', 'doc.'];