Improve docblocks

Author: sebastianbergmann

src/CodeCoverage.php

@@ -736,6 +736,8 @@ private function getLinesToBeIgnored($filename)
                     case 'PHP_Token_TRAIT':
                     case 'PHP_Token_CLASS':
                     case 'PHP_Token_FUNCTION':
+                        /* @var PHP_Token_Interface $token */
+
                         $docblock = $token->getDocblock();
 
                         $this->ignoredLines[$filename][] = $token->getLine();

src/CodeCoverage/Util.php

@@ -16,9 +16,11 @@
 class PHP_CodeCoverage_Util
 {
     /**
-     * @param  float $a
-     * @param  float $b
-     * @return float ($a / $b) * 100
+     * @param  float            $a
+     * @param  float            $b
+     * @param  bool             $asString
+     * @param  bool             $fixedWidth
+     * @return float|int|string
      */
     public static function percent($a, $b, $asString = false, $fixedWidth = false)
     {

src/CodeCoverage/Util/InvalidArgumentHelper.php

@@ -17,9 +17,10 @@
 class PHP_CodeCoverage_Util_InvalidArgumentHelper
 {
     /**
-     * @param int    $argument
-     * @param string $type
-     * @param mixed  $value
+     * @param  int                        $argument
+     * @param  string                     $type
+     * @param  mixed                      $value
+     * @return PHP_CodeCoverage_Exception
      */
     public static function factory($argument, $type, $value = null)
     {