Remove superfluous phpdoc tags

Philippe Segatori · nicolas-grekas · commit 2c1cc0023710 · 2019-08-14T13:59:53.000+02:00
diff --git a/Exception/SyntaxErrorException.php b/Exception/SyntaxErrorException.php
@@ -25,7 +25,6 @@ class SyntaxErrorException extends ParseException
 {
     /**
      * @param string $expectedValue
-     * @param Token  $foundToken
      *
      * @return self
      */
diff --git a/Node/AttributeNode.php b/Node/AttributeNode.php
@@ -30,11 +30,10 @@ class AttributeNode extends AbstractNode
     private $value;
 
     /**
-     * @param NodeInterface $selector
-     * @param string        $namespace
-     * @param string        $attribute
-     * @param string        $operator
-     * @param string        $value
+     * @param string $namespace
+     * @param string $attribute
+     * @param string $operator
+     * @param string $value
      */
     public function __construct(NodeInterface $selector, $namespace, $attribute, $operator, $value)
     {
diff --git a/Node/ClassNode.php b/Node/ClassNode.php
@@ -27,8 +27,7 @@ class ClassNode extends AbstractNode
     private $name;
 
     /**
-     * @param NodeInterface $selector
-     * @param string        $name
+     * @param string $name
      */
     public function __construct(NodeInterface $selector, $name)
     {
diff --git a/Node/CombinedSelectorNode.php b/Node/CombinedSelectorNode.php
@@ -28,9 +28,7 @@ class CombinedSelectorNode extends AbstractNode
     private $subSelector;
 
     /**
-     * @param NodeInterface $selector
-     * @param string        $combinator
-     * @param NodeInterface $subSelector
+     * @param string $combinator
      */
     public function __construct(NodeInterface $selector, $combinator, NodeInterface $subSelector)
     {
diff --git a/Node/FunctionNode.php b/Node/FunctionNode.php
@@ -30,9 +30,8 @@ class FunctionNode extends AbstractNode
     private $arguments;
 
     /**
-     * @param NodeInterface $selector
-     * @param string        $name
-     * @param Token[]       $arguments
+     * @param string  $name
+     * @param Token[] $arguments
      */
     public function __construct(NodeInterface $selector, $name, array $arguments = [])
     {
diff --git a/Node/HashNode.php b/Node/HashNode.php
@@ -27,8 +27,7 @@ class HashNode extends AbstractNode
     private $id;
 
     /**
-     * @param NodeInterface $selector
-     * @param string        $id
+     * @param string $id
      */
     public function __construct(NodeInterface $selector, $id)
     {
diff --git a/Node/PseudoNode.php b/Node/PseudoNode.php
@@ -27,8 +27,7 @@ class PseudoNode extends AbstractNode
     private $identifier;
 
     /**
-     * @param NodeInterface $selector
-     * @param string        $identifier
+     * @param string $identifier
      */
     public function __construct(NodeInterface $selector, $identifier)
     {
diff --git a/Node/SelectorNode.php b/Node/SelectorNode.php
@@ -27,8 +27,7 @@ class SelectorNode extends AbstractNode
     private $pseudoElement;
 
     /**
-     * @param NodeInterface $tree
-     * @param string|null   $pseudoElement
+     * @param string|null $pseudoElement
      */
     public function __construct(NodeInterface $tree, $pseudoElement = null)
     {
diff --git a/Parser/Parser.php b/Parser/Parser.php
@@ -158,8 +158,7 @@ private function parserSelectorNode(TokenStream $stream)
     /**
      * Parses next simple node (hash, class, pseudo, negation).
      *
-     * @param TokenStream $stream
-     * @param bool        $insideNegation
+     * @param bool $insideNegation
      *
      * @return array
      *
diff --git a/XPath/Extension/AttributeMatchingExtension.php b/XPath/Extension/AttributeMatchingExtension.php
@@ -44,9 +44,8 @@ public function getAttributeMatchingTranslators()
     }
 
     /**
-     * @param XPathExpr $xpath
-     * @param string    $attribute
-     * @param string    $value
+     * @param string $attribute
+     * @param string $value
      *
      * @return XPathExpr
      */
@@ -56,9 +55,8 @@ public function translateExists(XPathExpr $xpath, $attribute, $value)
     }
 
     /**
-     * @param XPathExpr $xpath
-     * @param string    $attribute
-     * @param string    $value
+     * @param string $attribute
+     * @param string $value
      *
      * @return XPathExpr
      */
@@ -68,9 +66,8 @@ public function translateEquals(XPathExpr $xpath, $attribute, $value)
     }
 
     /**
-     * @param XPathExpr $xpath
-     * @param string    $attribute
-     * @param string    $value
+     * @param string $attribute
+     * @param string $value
      *
      * @return XPathExpr
      */
@@ -84,9 +81,8 @@ public function translateIncludes(XPathExpr $xpath, $attribute, $value)
     }
 
     /**
-     * @param XPathExpr $xpath
-     * @param string    $attribute
-     * @param string    $value
+     * @param string $attribute
+     * @param string $value
      *
      * @return XPathExpr
      */
@@ -101,9 +97,8 @@ public function translateDashMatch(XPathExpr $xpath, $attribute, $value)
     }
 
     /**
-     * @param XPathExpr $xpath
-     * @param string    $attribute
-     * @param string    $value
+     * @param string $attribute
+     * @param string $value
      *
      * @return XPathExpr
      */
@@ -117,9 +112,8 @@ public function translatePrefixMatch(XPathExpr $xpath, $attribute, $value)
     }
 
     /**
-     * @param XPathExpr $xpath
-     * @param string    $attribute
-     * @param string    $value
+     * @param string $attribute
+     * @param string $value
      *
      * @return XPathExpr
      */
@@ -134,9 +128,8 @@ public function translateSuffixMatch(XPathExpr $xpath, $attribute, $value)
     }
 
     /**
-     * @param XPathExpr $xpath
-     * @param string    $attribute
-     * @param string    $value
+     * @param string $attribute
+     * @param string $value
      *
      * @return XPathExpr
      */
@@ -150,9 +143,8 @@ public function translateSubstringMatch(XPathExpr $xpath, $attribute, $value)
     }
 
     /**
-     * @param XPathExpr $xpath
-     * @param string    $attribute
-     * @param string    $value
+     * @param string $attribute
+     * @param string $value
      *
      * @return XPathExpr
      */
diff --git a/XPath/Extension/FunctionExtension.php b/XPath/Extension/FunctionExtension.php
@@ -46,10 +46,8 @@ public function getFunctionTranslators()
     }
 
     /**
-     * @param XPathExpr    $xpath
-     * @param FunctionNode $function
-     * @param bool         $last
-     * @param bool         $addNameTest
+     * @param bool $last
+     * @param bool $addNameTest
      *
      * @return XPathExpr
      *
diff --git a/XPath/Translator.php b/XPath/Translator.php
@@ -180,9 +180,7 @@ public function nodeToXPath(NodeInterface $node)
     }
 
     /**
-     * @param string        $combiner
-     * @param NodeInterface $xpath
-     * @param NodeInterface $combinedXpath
+     * @param string $combiner
      *
      * @return XPathExpr
      *
@@ -212,8 +210,7 @@ public function addFunction(XPathExpr $xpath, FunctionNode $function)
     }
 
     /**
-     * @param XPathExpr $xpath
-     * @param string    $pseudoClass
+     * @param string $pseudoClass
      *
      * @return XPathExpr
      *
@@ -229,10 +226,9 @@ public function addPseudoClass(XPathExpr $xpath, $pseudoClass)
     }
 
     /**
-     * @param XPathExpr $xpath
-     * @param string    $operator
-     * @param string    $attribute
-     * @param string    $value
+     * @param string $operator
+     * @param string $attribute
+     * @param string $value
      *
      * @return XPathExpr
      *
diff --git a/XPath/TranslatorInterface.php b/XPath/TranslatorInterface.php
@@ -38,8 +38,7 @@ public function cssToXPath($cssExpr, $prefix = 'descendant-or-self::');
     /**
      * Translates a parsed selector node to an XPath expression.
      *
-     * @param SelectorNode $selector
-     * @param string       $prefix
+     * @param string $prefix
      *
      * @return string
      */

Original file line number	Diff line number	Diff line change
`@@ -25,7 +25,6 @@ class SyntaxErrorException extends ParseException`
`25`	`25`	`{`
`26`	`26`	`/**`
`27`	`27`	`* @param string $expectedValue`
`28`		`- * @param Token $foundToken`
`29`	`28`	`*`
`30`	`29`	`* @return self`
`31`	`30`	`*/`
Original file line number	Diff line number	Diff line change
`@@ -27,8 +27,7 @@ class ClassNode extends AbstractNode`
`27`	`27`	`private $name;`
`28`	`28`
`29`	`29`	`/**`
`30`		`- * @param NodeInterface $selector`
`31`		`- * @param string $name`
	`30`	`+ * @param string $name`
`32`	`31`	`*/`
`33`	`32`	`public function __construct(NodeInterface $selector, $name)`
`34`	`33`	`{`
Original file line number	Diff line number	Diff line change
`@@ -27,8 +27,7 @@ class HashNode extends AbstractNode`
`27`	`27`	`private $id;`
`28`	`28`
`29`	`29`	`/**`
`30`		`- * @param NodeInterface $selector`
`31`		`- * @param string $id`
	`30`	`+ * @param string $id`
`32`	`31`	`*/`
`33`	`32`	`public function __construct(NodeInterface $selector, $id)`
`34`	`33`	`{`
Original file line number	Diff line number	Diff line change
`@@ -27,8 +27,7 @@ class PseudoNode extends AbstractNode`
`27`	`27`	`private $identifier;`
`28`	`28`
`29`	`29`	`/**`
`30`		`- * @param NodeInterface $selector`
`31`		`- * @param string $identifier`
	`30`	`+ * @param string $identifier`
`32`	`31`	`*/`
`33`	`32`	`public function __construct(NodeInterface $selector, $identifier)`
`34`	`33`	`{`
Original file line number	Diff line number	Diff line change
`@@ -27,8 +27,7 @@ class SelectorNode extends AbstractNode`
`27`	`27`	`private $pseudoElement;`
`28`	`28`
`29`	`29`	`/**`
`30`		`- * @param NodeInterface $tree`
`31`		`- * @param string\|null $pseudoElement`
	`30`	`+ * @param string\|null $pseudoElement`
`32`	`31`	`*/`
`33`	`32`	`public function __construct(NodeInterface $tree, $pseudoElement = null)`
`34`	`33`	`{`
Original file line number	Diff line number	Diff line change
`@@ -158,8 +158,7 @@ private function parserSelectorNode(TokenStream $stream)`
`158`	`158`	`/**`
`159`	`159`	`* Parses next simple node (hash, class, pseudo, negation).`
`160`	`160`	`*`
`161`		`- * @param TokenStream $stream`
`162`		`- * @param bool $insideNegation`
	`161`	`+ * @param bool $insideNegation`
`163`	`162`	`*`
`164`	`163`	`* @return array`
`165`	`164`	`*`
Original file line number	Diff line number	Diff line change
`@@ -44,9 +44,8 @@ public function getAttributeMatchingTranslators()`
`44`	`44`	`}`
`45`	`45`
`46`	`46`	`/**`
`47`		`- * @param XPathExpr $xpath`
`48`		`- * @param string $attribute`
`49`		`- * @param string $value`
	`47`	`+ * @param string $attribute`
	`48`	`+ * @param string $value`
`50`	`49`	`*`
`51`	`50`	`* @return XPathExpr`
`52`	`51`	`*/`
`@@ -56,9 +55,8 @@ public function translateExists(XPathExpr $xpath, $attribute, $value)`
`56`	`55`	`}`
`57`	`56`
`58`	`57`	`/**`
`59`		`- * @param XPathExpr $xpath`
`60`		`- * @param string $attribute`
`61`		`- * @param string $value`
	`58`	`+ * @param string $attribute`
	`59`	`+ * @param string $value`
`62`	`60`	`*`
`63`	`61`	`* @return XPathExpr`
`64`	`62`	`*/`
`@@ -68,9 +66,8 @@ public function translateEquals(XPathExpr $xpath, $attribute, $value)`
`68`	`66`	`}`
`69`	`67`
`70`	`68`	`/**`
`71`		`- * @param XPathExpr $xpath`
`72`		`- * @param string $attribute`
`73`		`- * @param string $value`
	`69`	`+ * @param string $attribute`
	`70`	`+ * @param string $value`
`74`	`71`	`*`
`75`	`72`	`* @return XPathExpr`
`76`	`73`	`*/`
`@@ -84,9 +81,8 @@ public function translateIncludes(XPathExpr $xpath, $attribute, $value)`
`84`	`81`	`}`
`85`	`82`
`86`	`83`	`/**`
`87`		`- * @param XPathExpr $xpath`
`88`		`- * @param string $attribute`
`89`		`- * @param string $value`
	`84`	`+ * @param string $attribute`
	`85`	`+ * @param string $value`
`90`	`86`	`*`
`91`	`87`	`* @return XPathExpr`
`92`	`88`	`*/`
`@@ -101,9 +97,8 @@ public function translateDashMatch(XPathExpr $xpath, $attribute, $value)`
`101`	`97`	`}`
`102`	`98`
`103`	`99`	`/**`
`104`		`- * @param XPathExpr $xpath`
`105`		`- * @param string $attribute`
`106`		`- * @param string $value`
	`100`	`+ * @param string $attribute`
	`101`	`+ * @param string $value`
`107`	`102`	`*`
`108`	`103`	`* @return XPathExpr`
`109`	`104`	`*/`
`@@ -117,9 +112,8 @@ public function translatePrefixMatch(XPathExpr $xpath, $attribute, $value)`
`117`	`112`	`}`
`118`	`113`
`119`	`114`	`/**`
`120`		`- * @param XPathExpr $xpath`
`121`		`- * @param string $attribute`
`122`		`- * @param string $value`
	`115`	`+ * @param string $attribute`
	`116`	`+ * @param string $value`
`123`	`117`	`*`
`124`	`118`	`* @return XPathExpr`
`125`	`119`	`*/`
`@@ -134,9 +128,8 @@ public function translateSuffixMatch(XPathExpr $xpath, $attribute, $value)`
`134`	`128`	`}`
`135`	`129`
`136`	`130`	`/**`
`137`		`- * @param XPathExpr $xpath`
`138`		`- * @param string $attribute`
`139`		`- * @param string $value`
	`131`	`+ * @param string $attribute`
	`132`	`+ * @param string $value`
`140`	`133`	`*`
`141`	`134`	`* @return XPathExpr`
`142`	`135`	`*/`
`@@ -150,9 +143,8 @@ public function translateSubstringMatch(XPathExpr $xpath, $attribute, $value)`
`150`	`143`	`}`
`151`	`144`
`152`	`145`	`/**`
`153`		`- * @param XPathExpr $xpath`
`154`		`- * @param string $attribute`
`155`		`- * @param string $value`
	`146`	`+ * @param string $attribute`
	`147`	`+ * @param string $value`
`156`	`148`	`*`
`157`	`149`	`* @return XPathExpr`
`158`	`150`	`*/`
Original file line number	Diff line number	Diff line change
`@@ -46,10 +46,8 @@ public function getFunctionTranslators()`
`46`	`46`	`}`
`47`	`47`
`48`	`48`	`/**`
`49`		`- * @param XPathExpr $xpath`
`50`		`- * @param FunctionNode $function`
`51`		`- * @param bool $last`
`52`		`- * @param bool $addNameTest`
	`49`	`+ * @param bool $last`
	`50`	`+ * @param bool $addNameTest`
`53`	`51`	`*`
`54`	`52`	`* @return XPathExpr`
`55`	`53`	`*`
Original file line number	Diff line number	Diff line change
`@@ -180,9 +180,7 @@ public function nodeToXPath(NodeInterface $node)`
`180`	`180`	`}`
`181`	`181`
`182`	`182`	`/**`
`183`		`- * @param string $combiner`
`184`		`- * @param NodeInterface $xpath`
`185`		`- * @param NodeInterface $combinedXpath`
	`183`	`+ * @param string $combiner`
`186`	`184`	`*`
`187`	`185`	`* @return XPathExpr`
`188`	`186`	`*`
`@@ -212,8 +210,7 @@ public function addFunction(XPathExpr $xpath, FunctionNode $function)`
`212`	`210`	`}`
`213`	`211`
`214`	`212`	`/**`
`215`		`- * @param XPathExpr $xpath`
`216`		`- * @param string $pseudoClass`
	`213`	`+ * @param string $pseudoClass`
`217`	`214`	`*`
`218`	`215`	`* @return XPathExpr`
`219`	`216`	`*`
`@@ -229,10 +226,9 @@ public function addPseudoClass(XPathExpr $xpath, $pseudoClass)`
`229`	`226`	`}`
`230`	`227`
`231`	`228`	`/**`
`232`		`- * @param XPathExpr $xpath`
`233`		`- * @param string $operator`
`234`		`- * @param string $attribute`
`235`		`- * @param string $value`
	`229`	`+ * @param string $operator`
	`230`	`+ * @param string $attribute`
	`231`	`+ * @param string $value`
`236`	`232`	`*`
`237`	`233`	`* @return XPathExpr`
`238`	`234`	`*`
Original file line number	Diff line number	Diff line change
`@@ -38,8 +38,7 @@ public function cssToXPath($cssExpr, $prefix = 'descendant-or-self::');`
`38`	`38`	`/**`
`39`	`39`	`* Translates a parsed selector node to an XPath expression.`
`40`	`40`	`*`
`41`		`- * @param SelectorNode $selector`
`42`		`- * @param string $prefix`
	`41`	`+ * @param string $prefix`
`43`	`42`	`*`
`44`	`43`	`* @return string`
`45`	`44`	`*/`