warning while building .manual.xml
php ../base/configure.php --with-lang=it configure.php on PHP 8.2.12
Checking for source directory... base Checking for output filename... base/.manual.xml Checking whether to include CHM... no Checking for PHP executable... php.exe Checking for language to build... it Checking whether the language is supported... yes Checking for partial build... no Checking whether to enable detailed XML error messages... no Checking libxml version... 2.10.3 Checking whether to enable detailed error reporting (may segfault)... yes
doc-base: 80d13140e0dfd992e37672227e5400c445f7a77f en: 3bc8fc7b9785c335e55d83986e6cd8968498dcfb [behind 1] it: 782161213370039454ccbbf227dcd60b46fc1c2e (branch security) [ahead 1]
Iterating over extension specific version files... OK Saving it... OK Iterating over files for sources info... OK Generating sources XML... OK Saving sources.xml file... OK Modification history file en/fileModHistory.php not found. Creating empty modification history file...done. Creating file-entities.ent... done Checking for if we should generate a simplified file... no Checking whether to save an invalid .manual.xml... no Loading and parsing manual.xml... 1 2 done. Running XInclude/XPointer... 0 1 0 done. Performed 1 XIncludes.
[base/temp/manual.xml 624345:0] could not load base/temp/manual.xml, and no fallback was found
Validating manual.xml... done.
All good. Saved .manual.xml
All you have to do now is run 'phd -d base/.manual.xml'
If the script hangs here, you can abort with ^C.
_ ... __
) ( /
/ \ | d b | =\ Y =/--..-="````"-. '.=__.-'
o/ /\
| | \ \ / )
\ .--""`\ < \ '-' /
// | || \ '---'
jgs ((,,/ ((,,__/
There are a dozen warnings issued by doc-base/script/broken.php on doc-it. The build system is known to misbehave in this case. These warnings are "easy" to fix, and may fix the warning (I'm not certain).
The good news is that:
Validating manual.xml... done.
All good. Saved .manual.xml
means the manual is complete enough to pass validation. You can ignore this warning for now.
Please, reopen this issue when the broken.php warnings are fixed. I will try to find the cause, but as doc-it has many untranslated files, the warning may continue.
at this position
<![CDATA[
<?php
function renderKernelTable($matrix) {
$output = "<table class='infoTable'>";
foreach ($matrix as $row) {
$output .= "<tr>";
foreach ($row as $cell) {
$output .= "<td style='text-align:left'>";
if ($cell === false) {
$output .= "false";
}
else {
$output .= round($cell, 3);
}
$output .= "</td>";
}
$output .= "</tr>";
}
$output .= "</table>";
return $output;
}
$output = "The built-in kernel name 'ring' with parameters of '2,3.5':<br/>";
$kernel = \ImagickKernel::fromBuiltIn(
\Imagick::KERNEL_RING,
"2,3.5"
);
$matrix = $kernel->getMatrix();
$output .= renderKernelTable($matrix);
echo $output;
?>
]]>
Maybe you can try: https://github.com/php/doc-en/pull/4330#issuecomment-2557306828
The error around line 624k is XPointer related. Commenting out the cases on function xinclude_residual(), generates:
Running XInclude/XPointer... 0 1 0 done. Performed 11 XIncludes.
Unknown parent of failed XInclude: refsect1
Unknown parent of failed XInclude: variablelist
Meaning there is two XInlclude that is failing. As doc-it is very outdated, the error will only go away by updating the XInclude source or the XInclude target. I will push a change on configure.php to warn about the XIncludes that failed.
sometimes the warning line changes
[file:/C:/Users/Manuel/OneDrive/Pictures/Documents/Sviluppo/php/document/base/temp/manual.xml 625126:0] could not load file:/C:/Users/Manuel/OneDrive/Pictures/Documents/Sviluppo/php/document/base/temp/manual.xml, and no fallback was found
625125 $kernel = \ImagickKernel::fromMatrix($matrix2);
625126 $output .= "Scaling by correlate
";
625127 $kernel->scale(1, \Imagick::NORMALIZE_KERNEL_CORRELATE);
625128 $output .= renderKernelTable($kernel->getMatrix());
Yes, the error will change as doc-en is updated. See the PR mentioned above. When it is merged, the doc-it will start generating these warnings:
Failed XInclude: xmlns(db=http://docbook.org/ns/docbook) xpointer(id('function.bcadd')/db:refsect1[@role='errors']/*)
Failed XInclude: bcmath-number.round..parameters.mode
Merged PR 227, so the cause of erros will now be evident.