Add/Fix docblocks

Author: sebastianbergmann

src/CodeCoverage/Filter.php

@@ -218,7 +218,8 @@ public function removeFileFromWhitelist($filename)
     /**
      * Checks whether a filename is a real filename.
      *
-     * @param string $filename
+     * @param  string $filename
+     * @return boolean
      */
     public function isFile($filename)
     {
@@ -240,8 +241,7 @@ public function isFile($filename)
      * When the whitelist is empty (default), blacklisting is used.
      * When the whitelist is not empty, whitelisting is used.
      *
-     * @param  string                     $filename
-     * @param  boolean                    $ignoreWhitelist
+     * @param  string $filename
      * @return boolean
      * @throws PHP_CodeCoverage_Exception
      */

src/CodeCoverage/Report/Factory.php

@@ -57,7 +57,8 @@
 class PHP_CodeCoverage_Report_Factory
 {
     /**
-     * @param PHP_CodeCoverage $coverage
+     * @param  PHP_CodeCoverage $coverage
+     * @return PHP_CodeCoverage_Report_Node_Directory
      */
     public function create(PHP_CodeCoverage $coverage)
     {

src/CodeCoverage/Report/HTML/Renderer.php

@@ -211,6 +211,10 @@ protected function setCommonTemplateVariables(Text_Template $template, PHP_CodeC
         );
     }
 
+    /**
+     * @param  PHP_CodeCoverage_Report_Node $node
+     * @return string
+     */
     protected function getBreadcrumbs(PHP_CodeCoverage_Report_Node $node)
     {
         $breadcrumbs = '';
@@ -239,6 +243,10 @@ protected function getBreadcrumbs(PHP_CodeCoverage_Report_Node $node)
         return $breadcrumbs;
     }
 
+    /**
+     * @param  PHP_CodeCoverage_Report_Node $node
+     * @return string
+     */
     protected function getActiveBreadcrumb(PHP_CodeCoverage_Report_Node $node)
     {
         $buffer = sprintf(
@@ -253,6 +261,11 @@ protected function getActiveBreadcrumb(PHP_CodeCoverage_Report_Node $node)
         return $buffer;
     }
 
+    /**
+     * @param  PHP_CodeCoverage_Report_Node $node
+     * @param  $pathToRoot
+     * @return string
+     */
     protected function getInactiveBreadcrumb(PHP_CodeCoverage_Report_Node $node, $pathToRoot)
     {
         return sprintf(
@@ -262,6 +275,10 @@ protected function getInactiveBreadcrumb(PHP_CodeCoverage_Report_Node $node, $pa
         );
     }
 
+    /**
+     * @param  PHP_CodeCoverage_Report_Node $node
+     * @return string
+     */
     protected function getPathToRoot(PHP_CodeCoverage_Report_Node $node)
     {
         $id    = $node->getId();
@@ -275,6 +292,10 @@ protected function getPathToRoot(PHP_CodeCoverage_Report_Node $node)
         return str_repeat('../', $depth);
     }
 
+    /**
+     * @param  float $percent
+     * @return string
+     */
     protected function getCoverageBar($percent)
     {
         $level = $this->getColorLevel($percent);

src/CodeCoverage/Report/HTML/Renderer/File.php

@@ -272,6 +272,8 @@ protected function renderFunctionItems(array $functions, Text_Template $template
 
     /**
      * @param  Text_Template $template
+     * @param  array         $item
+     * @param  string        $indent
      * @return string
      */
     protected function renderFunctionOrMethodItem(Text_Template $template, array $item, $indent = '')

src/CodeCoverage/Util.php

@@ -57,8 +57,10 @@
 class PHP_CodeCoverage_Util
 {
     /**
-     * @param  float $a
-     * @param  float $b
+     * @param  float   $a
+     * @param  float   $b
+     * @param  boolean $asString
+     * @param  boolean $fixedWidth
      * @return float ($a / $b) * 100
      */
     public static function percent($a, $b, $asString = false, $fixedWidth = false)

src/CodeCoverage/Util/InvalidArgumentHelper.php

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