Fix doc generation for when '%' exist in the docblocks

docgen/FunctionDocumentation.php

@@ -83,9 +83,19 @@ public function asMethodTag(): Method
             $description .= '<h2>Returns</h2>';
             $description .= Parsers::$markdown->text($this->returnDescription);
         }
+
+        //
+        // Perform some cleanup on the description we just built
+        //
+
+        // Replace newlines with `<br>` tags since IDEs parse docblocks as HTML
         $descriptionBody = trim(preg_replace('/\n/', ' ', $this->summary . '<br>' . $description));
+
+        // Don't allow trailing `<br>` tags
         $descriptionBody = preg_replace('/<br>$/', '', $descriptionBody);
-        $description = new Description($descriptionBody);
+
+        // Escape percent signs because this string will go through a `sprintf()` call so having a single `%` will cause an error
+        $descriptionBody = preg_replace('/([^%])%([^%])/m', '\1%%\2', $descriptionBody);
 
         return new Method(
             $this->name,
@@ -94,7 +104,7 @@ public function asMethodTag(): Method
             }),
             $this->returnType,
             true,
-            $description
+            new Description($descriptionBody)
         );
     }
 

tools/phpDocGen.php

@@ -114,9 +114,7 @@ function buildCoreFunctionLoader()
     $docBlockLiteral = writeDocBlock(new DocBlock(
         '',
         null,
-        __::map($registry->methods, function (FunctionDocumentation $fxnDoc) {
-            return $fxnDoc->asMethodTag();
-        })
+        __::map($registry->methods, static fn (FunctionDocumentation $fxnDoc) => $fxnDoc->asMethodTag())
     ));
 
     /** @var Stmt $astNode */