gen_stub: documentation updates

* Use `@param` instead of `@var` for parameters
* Fix type of `$attributeGroups` in `AttributeInfo::createFromGroups()`
* Remove extra documentation of `$allConstInfo` for
`ClassInfo::getClassSynopsisDocument()`, it is already documented under the
correct name `$allConstInfos`
* Remove unneeded `@throws`

Author: DanielEScherzer

build/gen_stub.php

@@ -1656,9 +1656,6 @@ private function generateRefSect1(DOMDocument $doc, string $role): DOMElement {
         return $refSec;
     }
 
-    /**
-     * @throws Exception
-     */
     public function getMethodSynopsisDocument(): ?string {
         $REFSEC1_SEPERATOR = "\n\n ";
 
@@ -2087,9 +2084,6 @@ private function getExampleSection(DOMDocument $doc, string $id): DOMElement {
         return $refSec;
     }
 
-    /**
-     * @throws Exception
-     */
     public function getMethodSynopsisElement(DOMDocument $doc): ?DOMElement {
         if ($this->hasParamWithUnknownDefaultValue()) {
             return null;
@@ -2411,7 +2405,7 @@ abstract class VariableLike
     protected /* readonly */ ?ExposedDocComment $exposedDocComment;
 
     /**
-     * @var AttributeInfo[] $attributes
+     * @param AttributeInfo[] $attributes
      */
     public function __construct(
         int $flags,
@@ -2594,7 +2588,7 @@ class ConstInfo extends VariableLike
     private /* readonly */ bool $isFileCacheAllowed;
 
     /**
-     * @var AttributeInfo[] $attributes
+     * @param AttributeInfo[] $attributes
      */
     public function __construct(
         AbstractConstName $name,
@@ -3048,7 +3042,7 @@ class PropertyInfo extends VariableLike
     ];
 
     /**
-     * @var AttributeInfo[] $attributes
+     * @param AttributeInfo[] $attributes
      */
     public function __construct(
         PropertyName $name,
@@ -3346,7 +3340,7 @@ public function generateCode(string $invocation, string $nameSuffix, array $allC
     }
 
     /**
-     * @param array<int, array<int, AttributeGroup>> $attributeGroups
+     * @param AttributeGroup[] $attributeGroups
      * @return AttributeInfo[]
      */
     public static function createFromGroups(array $attributeGroups): array {
@@ -3706,7 +3700,6 @@ public function discardInfoForOldPhpVersions(?int $phpVersionIdMinimumCompatibil
     /**
      * @param array<string, ClassInfo> $classMap
      * @param array<string, ConstInfo> $allConstInfos
-     * @param iterable<ConstInfo> $allConstInfo
      */
     public function getClassSynopsisDocument(array $classMap, array $allConstInfos): ?string {
         $doc = new DOMDocument();