`make build` でビルドできない

[jdkfx]

概要

make build時にWrong XML file:と、Broken XML file:というエラーが出ているため、ビルドができない。

jdkfx@HarukinoMacBook-Air phpdoc % make build
php doc-base/configure.php --with-lang=ja
configure.php on PHP 8.4.1, libxml 2.9.13

Checking for source directory... /Users/jdkfx/Desktop/workspace/phpdoc/doc-base
Checking for output filename... /Users/jdkfx/Desktop/workspace/phpdoc/doc-base/.manual.xml
Checking whether to include CHM... no
Checking for PHP executable... /usr/local/Cellar/php/8.4.1/bin/php
Checking for language to build... ja
Checking whether the language is supported... yes
Checking for partial build... no
Checking whether to enable detailed XML error messages... no
Checking whether to enable detailed error reporting (may segfault)... yes

doc-base: 048256b6c930d0c2e03903e0e9614d8f85441eb6 
en:       d0ae617680e58bde494f9d58d9c553e0a6944418 
ja:       661e9cc30986e6e6685c755451071eee8c7beaa8

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 1 2 done. Performed 1605 XIncludes.

Failed XIncludes, manual parts will be missing. Inspect temp/xinclude-debug.xml for context. Failed targets are:
- domxpath.registerphpfunctions..errors
- domxpath.registerphpfunctions..errors

Validating manual.xml... done.
PhD history: not found, creating empty, done.
PhD sources: reading, transforming, saving, done.
PhD version: reading, transforming, saving, done.

All good. Saved .manual.xml
All you have to do now is run 'phd -d /Users/jdkfx/Desktop/workspace/phpdoc/doc-base/.manual.xml'
If the script hangs here, you can abort with ^C.
         _ _..._ __
        \)`    (` /
         /      `\
        |  d  b   |
        =\  Y    =/--..-="````"-.
          '.=__.-'               `\
             o/                 /\ \
              |                 | \ \   / )
               \    .--""`\    <   \ '-' /
              //   |      ||    \   '---'
         jgs ((,,_/      ((,,___/

Wrong XML file:
  Issue: XML file contains \r. Several tools may misbehave.
  Path:  /Users/jdkfx/Desktop/workspace/phpdoc/ja/chmonly/aboutchm.xml
  Hint:  You can try autofix this with 'doc-base/scripts/broken.php --dos2unix langdir'.

....

Broken XML file:
  Issue: Start tag expected, '<' not found
  Path:  /Users/jdkfx/Desktop/workspace/phpdoc/ja/reference/mysql_xdevapi/entities.functions.xml [1,1]

....

Wrong XML file:
  Issue: XML file contains \r. Several tools may misbehave.
  Path:  /Users/jdkfx/Desktop/workspace/phpdoc/ja/reference/oci8/dtrace.xml
  Hint:  You can try autofix this with 'doc-base/scripts/broken.php --dos2unix langdir'.

試したこと

php バージョンの違いによる問題の切り分け

• 以前はphp8.3で動作をしていたため、今回ローカルでbuildしていた際に利用していたphpのバージョンと差異があり問題が起きていると仮定したが、php8.3においても同様のエラーが起きてしまった

dos2unixによるフォーマットの変更

brew install dos2unix

にてdos2unixをインストールし、下記を実行した

jdkfx@HarukinoMacBook-Air phpdoc % php doc-base/scripts/broken.php --dos2unix ja     
Wrong XML file:
  Issue: XML file contains \r. Several tools may misbehave.
  Path:  /Users/jdkfx/Desktop/workspace/phpdoc/ja/chmonly/aboutchm.xml
  Hint:  You can try autofix this with 'doc-base/scripts/broken.php --dos2unix langdir'.

dos2unix: converting file /Users/jdkfx/Desktop/workspace/phpdoc/ja/chmonly/aboutchm.xml to Unix format...

Unixフォーマットに変更したが、それにより翻訳用のファイルにも差分が大量に出てしまった

Wrong XML file:のエラーは消えたのだが、Broken XML file:のエラーは改善されず。

[chatii]

調べたのは \r についてだけですが

php/doc-base@181ecbe

これが原因なのかなと
で、もともと ja に \r\n でコミットされているファイルがあるのでコケるようになった

[alfsb]

これが原因なのかなと で、もともと ja に \r\n でコミットされているファイルがあるのでコケるようになった

doc-ja has about 7750 XML files with \n. And has 76 files with \r. These few files cause problems in some tools. Changing these files to use only \n will make the manual build to fail less in future.