warning while building .manual.xml

[ManueldG]

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: 80d1314
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 ((,,/ ((,,__/

[alfsb]

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.

[ManueldG]

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;
?>
]]>

[sy-records]

Maybe you can try: php/doc-en#4330 (comment)

[alfsb]

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.

[ManueldG]

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());

[alfsb]

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

[alfsb]

Merged PR 227, so the cause of erros will now be evident.