yiisoft / yii2

framework/widgets/LinkPager.php

Doc Comments +1 added lines, -1 removed lines

@@ -224,7 +224,7 @@
     }
 
     /**
-     * @return array the begin and end pages that need to be displayed.
+     * @return integer[] the begin and end pages that need to be displayed.
      */
     protected function getPageRange()
     {

framework/db/BaseActiveRecord.php

Doc Comments +1 added lines, -1 removed lines

@@ -788,7 +788,7 @@
      * In the above step 1 and 3, events named [[EVENT_BEFORE_DELETE]] and [[EVENT_AFTER_DELETE]]
      * will be raised by the corresponding methods.
      *
-     * @return integer|false the number of rows deleted, or false if the deletion is unsuccessful for some reason.
+     * @return boolean the number of rows deleted, or false if the deletion is unsuccessful for some reason.
      * Note that it is possible the number of rows deleted is 0, even though the deletion execution is successful.
      * @throws StaleObjectException if [[optimisticLock|optimistic locking]] is enabled and the data
      * being deleted is outdated.

framework/db/Query.php

Doc Comments +1 added lines, -1 removed lines

@@ -795,7 +795,7 @@
 
     /**
      * Appends a SQL statement using UNION operator.
-     * @param string|Query $sql the SQL statement to be appended using UNION
+     * @param Query $sql the SQL statement to be appended using UNION
      * @param boolean $all TRUE if using UNION ALL and FALSE if using UNION
      * @return $this the query object itself
      */

build/controllers/PhpDocController.php

Doc Comments +21 added lines, -2 removed lines

@@ -108,6 +108,9 @@ 
         return array_merge(parent::options($actionID), ['updateFiles']);
     }
 
+    /**
+     * @param string|null $root
+     */
     protected function findFiles($root)
     {
         $except = [];
@@ -266,6 +269,9 @@ 
         }
     }
 
+    /**
+     * @param string $line
+     */
     protected function fixParamTypes($line)
     {
         return preg_replace_callback('~@(param|return) ([\w\\|]+)~i', function($matches) {
@@ -390,6 +396,10 @@ 
         // TODO
     }
 
+    /**
+     * @param null|string $className
+     * @param string $propertyDoc
+     */
     protected function updateClassPropertyDocs($file, $className, $propertyDoc)
     {
         $ref = new \ReflectionClass($className);
@@ -459,7 +469,7 @@ 
     /**
      * remove multi empty lines and trim trailing whitespace
      *
-     * @param $doc
+     * @param string $doc
      * @return string
      */
     protected function cleanDocComment($doc)
@@ -478,7 +488,7 @@ 
 
     /**
      * Replace property annotations in doc comment
-     * @param $doc
+     * @param string $doc
      * @param $properties
      * @return string
      */
@@ -640,6 +650,9 @@ 
         return [$className, $phpdoc];
     }
 
+    /**
+     * @param string $pattern
+     */
     protected function match($pattern, $subject, $split = false)
     {
         $sets = [];
@@ -661,6 +674,9 @@ 
         return $sets;
     }
 
+    /**
+     * @param string $str
+     */
     protected function fixSentence($str)
     {
         // TODO fix word wrap
@@ -669,6 +685,9 @@ 
         return strtoupper(substr($str, 0, 1)) . substr($str, 1) . ($str[strlen($str) - 1] != '.' ? '.' : '');
     }
 
+    /**
+     * @param string $param
+     */
     protected function getPropParam($prop, $param)
     {
         return isset($prop['property']) ? $prop['property'][$param] : (isset($prop['get']) ? $prop['get'][$param] : $prop['set'][$param]);

framework/base/Security.php

Doc Comments +3 added lines, -3 removed lines

@@ -134,7 +134,7 @@ 
      * Verifies and decrypts data encrypted with [[encryptByPassword()]].
      * @param string $data the encrypted data to decrypt
      * @param string $password the password to use for decryption
-     * @return boolean|string the decrypted data or false on authentication failure
+     * @return false|string the decrypted data or false on authentication failure
      * @see encryptByPassword()
      */
     public function decryptByPassword($data, $password)
@@ -147,7 +147,7 @@ 
      * @param string $data the encrypted data to decrypt
      * @param string $inputKey the input to use for encryption and authentication
      * @param string $info optional context and application specific information, see [[hkdf()]]
-     * @return boolean|string the decrypted data or false on authentication failure
+     * @return false|string the decrypted data or false on authentication failure
      * @see encryptByKey()
      */
     public function decryptByKey($data, $inputKey, $info = null)
@@ -214,7 +214,7 @@ 
      * @param string $secret the decryption password or key
      * @param string $info context/application specific information, @see encrypt()
      *
-     * @return boolean|string the decrypted data or false on authentication failure
+     * @return false|string the decrypted data or false on authentication failure
      * @throws InvalidConfigException on OpenSSL not loaded
      * @throws Exception on OpenSSL error
      * @see encrypt()

framework/console/Controller.php

Doc Comments +4 added lines, -4 removed lines

@@ -186,7 +186,7 @@ 
      * ```
      *
      * @param string $string the string to print
-     * @return integer|boolean Number of bytes printed or false on error
+     * @return integer Number of bytes printed or false on error
      */
     public function stdout($string)
     {
@@ -211,7 +211,7 @@ 
      * ```
      *
      * @param string $string the string to print
-     * @return integer|boolean Number of bytes printed or false on error
+     * @return integer Number of bytes printed or false on error
      */
     public function stderr($string)
     {
@@ -251,7 +251,7 @@ 
      *
      * @param string $message to echo out before waiting for user input
      * @param boolean $default this value is returned if no selection is made.
-     * @return boolean whether user confirmed.
+     * @return boolean|null whether user confirmed.
      * Will return true if [[interactive]] is false.
      */
     public function confirm($message, $default = false)
@@ -287,7 +287,7 @@ 
      * until [[beforeAction()]] is being called.
      *
      * @param string $actionID the action id of the current request
-     * @return array the names of the options valid for the action
+     * @return string[] the names of the options valid for the action
      */
     public function options($actionID)
     {

framework/console/controllers/MessageController.php

Doc Comments +1 added lines, -1 removed lines

@@ -574,7 +574,7 @@
      * Finds out a line of the first non-char PHP token found
      *
      * @param array $tokens
-     * @return integer|string
+     * @return string
      * @since 2.0.1
      */
     protected function getLine($tokens)

framework/helpers/BaseConsole.php

Doc Comments +7 added lines, -7 removed lines

@@ -575,7 +575,7 @@ 
      * - windows without ansicon
      * - not tty consoles
      *
-     * @param mixed $stream
+     * @param resource $stream
      * @return boolean true if the stream supports ANSI colors, otherwise false.
      */
     public static function streamSupportsAnsiColors($stream)
@@ -600,7 +600,7 @@ 
      * @param boolean $refresh whether to force checking and not re-use cached size value.
      * This is useful to detect changing window size while the application is running but may
      * not get up to date values on every terminal.
-     * @return array|boolean An array of ($width, $height) or false when it was not able to determine size.
+     * @return string An array of ($width, $height) or false when it was not able to determine size.
      */
     public static function getScreenSize($refresh = false)
     {
@@ -691,7 +691,7 @@ 
      * Prints a string to STDOUT.
      *
      * @param string $string the string to print
-     * @return integer|boolean Number of bytes printed or false on error
+     * @return integer Number of bytes printed or false on error
      */
     public static function stdout($string)
     {
@@ -702,7 +702,7 @@ 
      * Prints a string to STDERR.
      *
      * @param string $string the string to print
-     * @return integer|boolean Number of bytes printed or false on error
+     * @return integer Number of bytes printed or false on error
      */
     public static function stderr($string)
     {
@@ -729,7 +729,7 @@ 
      * Prints text to STDOUT appended with a carriage return (PHP_EOL).
      *
      * @param string $string the text to print
-     * @return integer|boolean number of bytes printed or false on error.
+     * @return integer number of bytes printed or false on error.
      */
     public static function output($string = null)
     {
@@ -740,7 +740,7 @@ 
      * Prints text to STDERR appended with a carriage return (PHP_EOL).
      *
      * @param string $string the text to print
-     * @return integer|boolean number of bytes printed or false on error.
+     * @return integer number of bytes printed or false on error.
      */
     public static function error($string = null)
     {
@@ -806,7 +806,7 @@ 
      *
      * @param string $message to print out before waiting for user input
      * @param boolean $default this value is returned if no selection is made.
-     * @return boolean whether user confirmed
+     * @return boolean|null whether user confirmed
      */
     public static function confirm($message, $default = false)
     {