doc-base icon indicating copy to clipboard operation
doc-base copied to clipboard

warning while building .manual.xml

Open ManueldG opened this issue 11 months ago • 1 comments

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

ManueldG avatar Feb 19 '25 14:02 ManueldG

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.

alfsb avatar Feb 19 '25 16:02 alfsb

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

ManueldG avatar Mar 05 '25 22:03 ManueldG

Maybe you can try: https://github.com/php/doc-en/pull/4330#issuecomment-2557306828

sy-records avatar Mar 06 '25 05:03 sy-records

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.

alfsb avatar Mar 06 '25 13:03 alfsb

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

ManueldG avatar Mar 06 '25 13:03 ManueldG

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 avatar Mar 06 '25 13:03 alfsb

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

alfsb avatar Mar 07 '25 11:03 alfsb