Add PI processing support for common phrases

configure.php

@@ -797,6 +797,37 @@ function getFileModificationHistory(): array {
     }
 }
 
+echo "Process PI nodes...\n";
+if ($ac['LANG'] != 'en') {
+    if (file_exists($srcdir . '/pi_processing/langs/' . $ac['LANG'] . '.php')) {
+        require_once $srcdir . '/pi_processing/langs/' . $ac['LANG'] . '.php';
+    }
+}
+require_once $srcdir . '/pi_processing/langs/en.php';
+require_once $srcdir . '/pi_processing/processors.php';
+$xpath = new DOMXPath($dom);
+foreach ($xpath->query('//processing-instruction()') as $pi) {
+    if (!str_starts_with($pi->target, 'phpdoc')) {
+        continue;
+    }
+    // Don't care about generic phpdoc PI target
+    if ($pi->target === 'phpdoc') {
+        continue;
+    }
+
+    $fn = match ($pi->target) {
+        'phpdoc_error_ValueError_between' => error_section_value_error_between(...),
+        'phpdoc_error_ValueError_between_changelog' => error_section_value_error_between_changelog(...),
+    };
+    $data = explode(' ', $pi->data);
+    $raw_xml = $fn(...$data);
+
+    $localDom = new DOMDocument();
+    $localDom->loadXML($raw_xml);
+    $node = $dom->importNode($localDom->documentElement, true);
+    $pi->parentNode->insertBefore($node, $pi);
+}
+
 echo "Validating {$ac["INPUT_FILENAME"]}... ";
 flush();
 if ($ac['PARTIAL'] != '' && $ac['PARTIAL'] != 'no') { // {{{

pi_processing/langs/en.php

@@ -0,0 +1,25 @@
+<?php
+
+if (!defined('VALUE_ERROR_BETWEEN_ERROR_SECTION')) {
+    define('VALUE_ERROR_BETWEEN_ERROR_SECTION', <<<'CONTENT'
+<simpara xmlns="http://docbook.org/ns/docbook">
+ Throws a <exceptionname>ValueError</exceptionname> if <parameter>PARAMETER_NAME</parameter>
+ is less than MIN_TAG or greater than MAX_TAG.
+</simpara>
+CONTENT
+    );
+}
+
+if (!defined('VALUE_ERROR_BETWEEN_CHANGELOG')) {
+    define('VALUE_ERROR_BETWEEN_CHANGELOG', <<<'CONTENT'
+<row xmlns="http://docbook.org/ns/docbook">
+ <entry>VERSION</entry>
+ <entry>
+  A <exceptionname>ValueError</exceptionname> is now thrown if
+  <parameter>PARAMETER_NAME</parameter> is less than MIN_TAG
+  or greater than MAX_TAG
+ </entry>
+</row>
+CONTENT
+    );
+}

pi_processing/langs/fr.php

@@ -0,0 +1,18 @@
+<?php
+
+const VALUE_ERROR_BETWEEN_ERROR_SECTION = <<<'CONTENT'
+<simpara>
+ Lance une <exceptionname>ValueError</exceptionname> si <parameter>PARAMETER_NAME</parameter>
+ est moins que MIN_TAG ou plus grand que MAX_TAG.
+</simpara>
+CONTENT;
+
+const VALUE_ERROR_BETWEEN_CHANGELOG = <<<'CONTENT'
+<row>
+ <entry>VERSION</entry>
+ <entry>
+  Une <exceptionname>ValueError</exceptionname> est désormais lancé si
+  <parameter>PARAMETER_NAME</parameter> est moins que MIN_TAG ou plus grand que MAX_TAG
+ </entry>
+</row>
+CONTENT;

pi_processing/processors.php

@@ -0,0 +1,38 @@
+<?php
+
+function error_section_value_error_between(
+    string $parameter,
+    string $min,
+    string $max
+): string {
+    $min_tag_name = is_numeric($min) ? 'literal' : 'constant';
+    $max_tag_name = is_numeric($max) ? 'literal' : 'constant';
+
+    $min_tag = '<' . $min_tag_name . '>' . $min . '</' . $min_tag_name . '>';
+    $max_tag = '<' . $max_tag_name . '>' . $max . '</' . $max_tag_name . '>';
+
+    return str_replace(
+        ['PARAMETER_NAME', 'MIN_TAG', 'MAX_TAG'],
+        [$parameter, $min_tag, $max_tag],
+        VALUE_ERROR_BETWEEN_ERROR_SECTION,
+    );
+}
+
+function error_section_value_error_between_changelog(
+    string $version,
+    string $parameter,
+    string $min,
+    string $max
+): string {
+    $min_tag_name = is_numeric($min) ? 'literal' : 'constant';
+    $max_tag_name = is_numeric($max) ? 'literal' : 'constant';
+
+    $min_tag = '<' . $min_tag_name . '>' . $min . '</' . $min_tag_name . '>';
+    $max_tag = '<' . $max_tag_name . '>' . $max . '</' . $max_tag_name . '>';
+
+    return str_replace(
+        ['VERSION', 'PARAMETER_NAME', 'MIN_TAG', 'MAX_TAG'],
+        [$version, $parameter, $min_tag, $max_tag],
+        VALUE_ERROR_BETWEEN_CHANGELOG,
+    );
+}