Merge pull request #58 from amllano/master

Skip "unused formal parameter" checking when method signature has been annotated as inherited using @inheritdoc

src/main/php/PHP/PMD/Rule/UnusedFormalParameter.php

@@ -88,6 +88,10 @@ public function apply(PHP_PMD_AbstractNode $node)
         if ($this->isAbstractMethod($node)) {
             return;
         }
+
+        if ($this->isInheritedSignature($node)) {
+            return;
+        }
 
         if ($this->isNotDeclaration($node)) {
             return;
@@ -117,7 +121,24 @@ private function isAbstractMethod(PHP_PMD_AbstractNode $node)
         }
         return false;
     }
-
+
+    /**
+     * Returns <b>true</b> when the given node is method with signature declared as inherited using
+     * {@inheritdoc} annotation.
+     * 
+     * @param PHP_PMD_AbstractNode $node The context method or function instance.
+     *
+     * @return boolean
+     */
+     private function isInheritedSignature(PHP_PMD_AbstractNode $node) 
+     {
+        if ($node instanceof PHP_PMD_Node_Method) {
+            return preg_match('/\@inheritdoc/', $node->getDocComment());
+        }
+
+        return false;
+    }
+
     /**
      * Tests if the given <b>$node</b> is a method and if this method is also
      * the initial declaration.