Create class aliases

Author: nielsdos

ext/dom/php_dom.stub.php

@@ -239,6 +239,7 @@
      */
     const DOM_VALIDATION_ERR = UNKNOWN;
 
+    /** @alias DOM\DocumentType */
     class DOMDocumentType extends DOMNode
     {
         /** @readonly */
@@ -260,16 +261,19 @@ class DOMDocumentType extends DOMNode
         public ?string $internalSubset;
     }
 
+    /** @alias DOM\CDATASection */
     class DOMCdataSection extends DOMText
     {
         public function __construct(string $data) {}
     }
 
+    /** @alias DOM\Comment */
     class DOMComment extends DOMCharacterData
     {
         public function __construct(string $data = "") {}
     }
 
+    /** @alias DOM\ParentNode */
     interface DOMParentNode
     {
         /** @param DOMNode|string $nodes */
@@ -282,6 +286,7 @@ public function prepend(...$nodes): void;
         public function replaceChildren(...$nodes): void;
     }
 
+    /** @alias DOM\ChildNode */
     interface DOMChildNode
     {
         public function remove(): void;
@@ -296,7 +301,10 @@ public function after(...$nodes): void;
         public function replaceWith(...$nodes): void;
     }
 
-    /** @not-serializable */
+    /**
+     * @not-serializable
+     * @alias DOM\Node
+     */
     class DOMNode
     {
         public const int DOCUMENT_POSITION_DISCONNECTED = 0x01;
@@ -417,7 +425,10 @@ public function getRootNode(?array $options = null): DOMNode {}
         public function compareDocumentPosition(DOMNode $other): int {}
     }
 
-    /** @not-serializable */
+    /**
+     * @not-serializable
+     * @alias DOM\NameSpaceNode
+     */
     class DOMNameSpaceNode
     {
         /** @readonly */
@@ -451,6 +462,7 @@ class DOMNameSpaceNode
         public ?DOMElement $parentElement;
     }
 
+    /** @alias DOM\Implementation */
     class DOMImplementation
     {
         /** @tentative-return-type */
@@ -466,6 +478,7 @@ public function createDocumentType(string $qualifiedName, string $publicId = "",
         public function createDocument(?string $namespace = null, string $qualifiedName = "", ?DOMDocumentType $doctype = null) {}
     }
 
+    /** @alias DOM\DocumentFragment */
     class DOMDocumentFragment extends DOMNode implements DOMParentNode
     {
         /** @readonly */
@@ -501,6 +514,7 @@ public function prepend(...$nodes): void {}
         public function replaceChildren(...$nodes): void {}
     }
 
+    /** @alias DOM\NodeList */
     class DOMNodeList implements IteratorAggregate, Countable
     {
         /** @readonly */
@@ -515,6 +529,7 @@ public function getIterator(): Iterator {}
         public function item(int $index) {}
     }
 
+    /** @alias DOM\CharacterData */
     class DOMCharacterData extends DOMNode implements DOMChildNode
     {
         public string $data;
@@ -565,6 +580,7 @@ public function before(... $nodes): void {}
         public function after(...$nodes): void {}
     }
 
+    /** @alias DOM\Attr */
     class DOMAttr extends DOMNode
     {
         /** @readonly */
@@ -587,6 +603,7 @@ public function __construct(string $name, string $value = "") {}
         public function isId(): bool {}
     }
 
+    /** @alias DOM\Element */
     class DOMElement extends DOMNode implements DOMParentNode, DOMChildNode
     {
         /** @readonly */
@@ -875,6 +892,7 @@ public function prepend(...$nodes): void {}
         public function replaceChildren(...$nodes): void {}
     }
 
+    /** @alias DOM\Exception */
     final class DOMException extends Exception
     {
         /**
@@ -884,6 +902,7 @@ final class DOMException extends Exception
         public $code = 0; // TODO add proper type (i.e. int|string)
     }
 
+    /** @alias DOM\Text */
     class DOMText extends DOMCharacterData
     {
         /** @readonly */
@@ -904,6 +923,7 @@ public function isElementContentWhitespace(): bool {}
         public function splitText(int $offset) {}
     }
 
+    /** @alias DOM\NamedNodeMap */
     class DOMNamedNodeMap implements IteratorAggregate, Countable
     {
         /** @readonly */
@@ -924,6 +944,7 @@ public function count(): int {}
         public function getIterator(): Iterator {}
     }
 
+    /** @alias DOM\Entity */
     class DOMEntity extends DOMNode
     {
         /** @readonly */
@@ -954,11 +975,13 @@ class DOMEntity extends DOMNode
         public ?string $version = null;
     }
 
+    /** @alias DOM\EntityReference */
     class DOMEntityReference extends DOMNode
     {
         public function __construct(string $name) {}
     }
 
+    /** @alias DOM\Notation */
     class DOMNotation extends DOMNode
     {
         /** @readonly */
@@ -968,6 +991,7 @@ class DOMNotation extends DOMNode
         public string $systemId;
     }
 
+    /** @alias DOM\ProcessingInstruction */
     class DOMProcessingInstruction extends DOMNode
     {
         /** @readonly */
@@ -979,7 +1003,10 @@ public function __construct(string $name, string $value = "") {}
     }
 
 #ifdef LIBXML_XPATH_ENABLED
-    /** @not-serializable */
+    /**
+     * @not-serializable
+     * @alias DOM\XPath
+     */
     class DOMXPath
     {
         /** @readonly */