Fix Xml_* function handler phpdoc

Author: VincentLanglet

extractor/extract.php

@@ -268,7 +268,7 @@ public function clear(): void
 			$pathPart = 'stubs/' . dirname($relativeStubPath) . '/' . str_replace('\\', '/', $namespacedName) . '.php';
 			$targetStubPath = __DIR__ . '/../' . $pathPart;
 
-			if ($stmt instanceof Node\Stmt\Class_ || $stmt instanceof Node\Stmt\Interface_ || $stmt instanceof Node\Stmt\Trait_) {
+			if ($stmt instanceof Node\Stmt\Class_ || $stmt instanceof Node\Stmt\Interface_ || $stmt instanceof Node\Stmt\Trait_ || $stmt instanceof Node\Stmt\Enum_) {
 				if (array_key_exists(strtolower($namespacedName), $classes)) {
 					continue;
 				}
@@ -279,6 +279,7 @@ public function clear(): void
 					continue;
 				}
 				$functions[strtolower($namespacedName)] = $pathPart;
+				$stmt = $this->filterFunctionPhpDocs($stmt);
 			}
 
 			$originalStmt = $stmt;
@@ -790,6 +791,44 @@ private function filterClassPhpDocs(Node\Stmt\ClassLike $class): Node\Stmt\Class
 		return $class;
 	}
 
+	private function filterFunctionPhpDocs(Node\Stmt\Function_ $function): Node\Stmt\Function_
+	{
+		$namespacedName = $function->namespacedName->toString();
+		if (in_array($namespacedName, [
+				'xml_set_element_handler',
+				'xml_set_character_data_handler',
+				'xml_set_processing_instruction_handler',
+				'xml_set_default_handler',
+				'xml_set_unparsed_entity_decl_handler',
+				'xml_set_notation_decl_handler',
+				'xml_set_external_entity_ref_handler',
+				'xml_set_start_namespace_decl_handler',
+				'xml_set_end_namespace_decl_handler',
+		], true)) {
+			$comments = $function->getAttribute('comments');
+			if (null !== $comments) {
+				$function->setAttribute('comments', array_map(
+					fn (Comment\Doc $doc): Comment\Doc => new Comment\Doc(
+						str_replace(
+							'@param callable $',
+							'@param callable|string|null $',
+							$doc->getText(),
+						),
+						$doc->getStartLine(),
+						$doc->getStartFilePos(),
+						$doc->getStartTokenPos(),
+						$doc->getEndLine(),
+						$doc->getEndFilePos(),
+						$doc->getEndTokenPos(),
+					),
+					$comments
+				));
+			}
+		}
+
+		return $function;
+	}
+
 	private function parseDocComment(string $docComment): PhpDocNode
 	{
 		$tokens = new TokenIterator($this->phpDocLexer->tokenize($docComment));