minor #47390 [CS] Remove @inheritdoc PHPDoc (lyrixx)

This PR was merged into the 6.2 branch.

Discussion
----------

[CS] Remove `@inheritdoc` PHPDoc

| Q             | A
| ------------- | ---
| Branch?       | 6.2
| Bug fix?      | no
| New feature?  | no
| Deprecations? | no
| Tickets       |
| License       | MIT
| Doc PR        |

---

It looks like this PHP Doc is useless. IDEs are able to inherit the doc (at least VS Code
and PHP Storm). And tools like PHP Stan are able to too https://phpstan.org/r/74a2c008-ff2b-42c0-8edf-8da87c1a7b5f

I could have open an RFC before doing the PR, but it was easy :) So let's discuss here

Commits
-------

015d5015e3 [CS] Remove `@inheritdoc` PHPDoc

Author: fabpot

Node/AttributeNode.php

@@ -63,9 +63,6 @@ public function getValue(): ?string
         return $this->value;
     }
 
-    /**
-     * {@inheritdoc}
-     */
     public function getSpecificity(): Specificity
     {
         return $this->selector->getSpecificity()->plus(new Specificity(0, 1, 0));

Node/ClassNode.php

@@ -42,9 +42,6 @@ public function getName(): string
         return $this->name;
     }
 
-    /**
-     * {@inheritdoc}
-     */
     public function getSpecificity(): Specificity
     {
         return $this->selector->getSpecificity()->plus(new Specificity(0, 1, 0));

Node/CombinedSelectorNode.php

@@ -49,9 +49,6 @@ public function getSubSelector(): NodeInterface
         return $this->subSelector;
     }
 
-    /**
-     * {@inheritdoc}
-     */
     public function getSpecificity(): Specificity
     {
         return $this->selector->getSpecificity()->plus($this->subSelector->getSpecificity());

Node/ElementNode.php

@@ -42,9 +42,6 @@ public function getElement(): ?string
         return $this->element;
     }
 
-    /**
-     * {@inheritdoc}
-     */
     public function getSpecificity(): Specificity
     {
         return new Specificity(0, 0, $this->element ? 1 : 0);

Node/FunctionNode.php

@@ -57,9 +57,6 @@ public function getArguments(): array
         return $this->arguments;
     }
 
-    /**
-     * {@inheritdoc}
-     */
     public function getSpecificity(): Specificity
     {
         return $this->selector->getSpecificity()->plus(new Specificity(0, 1, 0));

Node/HashNode.php

@@ -42,9 +42,6 @@ public function getId(): string
         return $this->id;
     }
 
-    /**
-     * {@inheritdoc}
-     */
     public function getSpecificity(): Specificity
     {
         return $this->selector->getSpecificity()->plus(new Specificity(1, 0, 0));

Node/NegationNode.php

@@ -42,9 +42,6 @@ public function getSubSelector(): NodeInterface
         return $this->subSelector;
     }
 
-    /**
-     * {@inheritdoc}
-     */
     public function getSpecificity(): Specificity
     {
         return $this->selector->getSpecificity()->plus($this->subSelector->getSpecificity());

Node/PseudoNode.php

@@ -42,9 +42,6 @@ public function getIdentifier(): string
         return $this->identifier;
     }
 
-    /**
-     * {@inheritdoc}
-     */
     public function getSpecificity(): Specificity
     {
         return $this->selector->getSpecificity()->plus(new Specificity(0, 1, 0));

Node/SelectorNode.php

@@ -42,9 +42,6 @@ public function getPseudoElement(): ?string
         return $this->pseudoElement;
     }
 
-    /**
-     * {@inheritdoc}
-     */
     public function getSpecificity(): Specificity
     {
         return $this->tree->getSpecificity()->plus(new Specificity(0, 0, $this->pseudoElement ? 1 : 0));

Parser/Handler/CommentHandler.php

@@ -26,9 +26,6 @@
  */
 class CommentHandler implements HandlerInterface
 {
-    /**
-     * {@inheritdoc}
-     */
     public function handle(Reader $reader, TokenStream $stream): bool
     {
         if ('/*' !== $reader->getSubstring(2)) {

Parser/Handler/HashHandler.php

@@ -38,9 +38,6 @@ public function __construct(TokenizerPatterns $patterns, TokenizerEscaping $esca
         $this->escaping = $escaping;
     }
 
-    /**
-     * {@inheritdoc}
-     */
     public function handle(Reader $reader, TokenStream $stream): bool
     {
         $match = $reader->findPattern($this->patterns->getHashPattern());

Parser/Handler/IdentifierHandler.php

@@ -38,9 +38,6 @@ public function __construct(TokenizerPatterns $patterns, TokenizerEscaping $esca
         $this->escaping = $escaping;
     }
 
-    /**
-     * {@inheritdoc}
-     */
     public function handle(Reader $reader, TokenStream $stream): bool
     {
         $match = $reader->findPattern($this->patterns->getIdentifierPattern());

Parser/Handler/NumberHandler.php

@@ -35,9 +35,6 @@ public function __construct(TokenizerPatterns $patterns)
         $this->patterns = $patterns;
     }
 
-    /**
-     * {@inheritdoc}
-     */
     public function handle(Reader $reader, TokenStream $stream): bool
     {
         $match = $reader->findPattern($this->patterns->getNumberPattern());

Parser/Handler/StringHandler.php

@@ -40,9 +40,6 @@ public function __construct(TokenizerPatterns $patterns, TokenizerEscaping $esca
         $this->escaping = $escaping;
     }
 
-    /**
-     * {@inheritdoc}
-     */
     public function handle(Reader $reader, TokenStream $stream): bool
     {
         $quote = $reader->getSubstring(1);

Parser/Handler/WhitespaceHandler.php

@@ -27,9 +27,6 @@
  */
 class WhitespaceHandler implements HandlerInterface
 {
-    /**
-     * {@inheritdoc}
-     */
     public function handle(Reader $reader, TokenStream $stream): bool
     {
         $match = $reader->findPattern('~^[ \t\r\n\f]+~');

Parser/Parser.php

@@ -34,9 +34,6 @@ public function __construct(Tokenizer $tokenizer = null)
         $this->tokenizer = $tokenizer ?? new Tokenizer();
     }
 
-    /**
-     * {@inheritdoc}
-     */
     public function parse(string $source): array
     {
         $reader = new Reader($source);

Parser/Shortcut/ClassParser.php

@@ -28,9 +28,6 @@
  */
 class ClassParser implements ParserInterface
 {
-    /**
-     * {@inheritdoc}
-     */
     public function parse(string $source): array
     {
         // Matches an optional namespace, optional element, and required class

Parser/Shortcut/ElementParser.php

@@ -27,9 +27,6 @@
  */
 class ElementParser implements ParserInterface
 {
-    /**
-     * {@inheritdoc}
-     */
     public function parse(string $source): array
     {
         // Matches an optional namespace, required element or `*`

Parser/Shortcut/EmptyStringParser.php

@@ -31,9 +31,6 @@
  */
 class EmptyStringParser implements ParserInterface
 {
-    /**
-     * {@inheritdoc}
-     */
     public function parse(string $source): array
     {
         // Matches an empty string

Parser/Shortcut/HashParser.php

@@ -28,9 +28,6 @@
  */
 class HashParser implements ParserInterface
 {
-    /**
-     * {@inheritdoc}
-     */
     public function parse(string $source): array
     {
         // Matches an optional namespace, optional element, and required id

XPath/Extension/AbstractExtension.php

@@ -23,41 +23,26 @@
  */
 abstract class AbstractExtension implements ExtensionInterface
 {
-    /**
-     * {@inheritdoc}
-     */
     public function getNodeTranslators(): array
     {
         return [];
     }
 
-    /**
-     * {@inheritdoc}
-     */
     public function getCombinationTranslators(): array
     {
         return [];
     }
 
-    /**
-     * {@inheritdoc}
-     */
     public function getFunctionTranslators(): array
     {
         return [];
     }
 
-    /**
-     * {@inheritdoc}
-     */
     public function getPseudoClassTranslators(): array
     {
         return [];
     }
 
-    /**
-     * {@inheritdoc}
-     */
     public function getAttributeMatchingTranslators(): array
     {
         return [];

XPath/Extension/AttributeMatchingExtension.php

@@ -26,9 +26,6 @@
  */
 class AttributeMatchingExtension extends AbstractExtension
 {
-    /**
-     * {@inheritdoc}
-     */
     public function getAttributeMatchingTranslators(): array
     {
         return [
@@ -109,9 +106,6 @@ public function translateDifferent(XPathExpr $xpath, string $attribute, ?string
         ));
     }
 
-    /**
-     * {@inheritdoc}
-     */
     public function getName(): string
     {
         return 'attribute-matching';

XPath/Extension/CombinationExtension.php

@@ -25,9 +25,6 @@
  */
 class CombinationExtension extends AbstractExtension
 {
-    /**
-     * {@inheritdoc}
-     */
     public function getCombinationTranslators(): array
     {
         return [
@@ -61,9 +58,6 @@ public function translateIndirectAdjacent(XPathExpr $xpath, XPathExpr $combinedX
         return $xpath->join('/following-sibling::', $combinedXpath);
     }
 
-    /**
-     * {@inheritdoc}
-     */
     public function getName(): string
     {
         return 'combination';

XPath/Extension/FunctionExtension.php

@@ -30,9 +30,6 @@
  */
 class FunctionExtension extends AbstractExtension
 {
-    /**
-     * {@inheritdoc}
-     */
     public function getFunctionTranslators(): array
     {
         return [
@@ -161,9 +158,6 @@ public function translateLang(XPathExpr $xpath, FunctionNode $function): XPathEx
         ));
     }
 
-    /**
-     * {@inheritdoc}
-     */
     public function getName(): string
     {
         return 'function';

XPath/Extension/HtmlExtension.php

@@ -36,9 +36,6 @@ public function __construct(Translator $translator)
             ->setFlag(NodeExtension::ATTRIBUTE_NAME_IN_LOWER_CASE, true);
     }
 
-    /**
-     * {@inheritdoc}
-     */
     public function getPseudoClassTranslators(): array
     {
         return [
@@ -53,9 +50,6 @@ public function getPseudoClassTranslators(): array
         ];
     }
 
-    /**
-     * {@inheritdoc}
-     */
     public function getFunctionTranslators(): array
     {
         return [
@@ -177,9 +171,6 @@ public function translateVisited(XPathExpr $xpath): XPathExpr
         return $xpath->addCondition('0');
     }
 
-    /**
-     * {@inheritdoc}
-     */
     public function getName(): string
     {
         return 'html';

XPath/Extension/NodeExtension.php

@@ -59,9 +59,6 @@ public function hasFlag(int $flag): bool
         return (bool) ($this->flags & $flag);
     }
 
-    /**
-     * {@inheritdoc}
-     */
     public function getNodeTranslators(): array
     {
         return [
@@ -182,9 +179,6 @@ public function translateElement(Node\ElementNode $node): XPathExpr
         return $xpath;
     }
 
-    /**
-     * {@inheritdoc}
-     */
     public function getName(): string
     {
         return 'node';

XPath/Extension/PseudoClassExtension.php

@@ -26,9 +26,6 @@
  */
 class PseudoClassExtension extends AbstractExtension
 {
-    /**
-     * {@inheritdoc}
-     */
     public function getPseudoClassTranslators(): array
     {
         return [
@@ -112,9 +109,6 @@ public function translateEmpty(XPathExpr $xpath): XPathExpr
         return $xpath->addCondition('not(*) and not(string-length())');
     }
 
-    /**
-     * {@inheritdoc}
-     */
     public function getName(): string
     {
         return 'pseudo-class';

XPath/Translator.php

@@ -87,9 +87,6 @@ public static function getXpathLiteral(string $element): string
         return sprintf('concat(%s)', implode(', ', $parts));
     }
 
-    /**
-     * {@inheritdoc}
-     */
     public function cssToXPath(string $cssExpr, string $prefix = 'descendant-or-self::'): string
     {
         $selectors = $this->parseSelectors($cssExpr);
@@ -106,9 +103,6 @@ public function cssToXPath(string $cssExpr, string $prefix = 'descendant-or-self
         return implode(' | ', $selectors);
     }
 
-    /**
-     * {@inheritdoc}
-     */
     public function selectorToXPath(SelectorNode $selector, string $prefix = 'descendant-or-self::'): string
     {
         return ($prefix ?: '').$this->nodeToXPath($selector);