[OpenJDK 8] Doc issue: FreeType minimum version should be 2.4.11 for Windows builds

[2840772674 at qq.com]

Dear OpenJDK Build Team,
I am writing to report an issue with the build documentation for OpenJDK 8. The current documentation in doc/build.html states that FreeType 2.3.0 is the minimum requirement for Windows builds. However, during my attempts to build OpenJDK 8 (update 362-ga) on Windows XP (x86) and Windows Server 2003 x64 Enterprise Edition, I encountered linker errors for the symbols _FT_Property_Set and _FT_Library_SetLcdFilter when using FreeType 2.3.0.
After investigating the source code, I found that these functions are used in jdk/src/share/native/sun/font/freetypeScaler.c at line 283. According to the FreeType documentation, the symbol _FT_Property_Set was introduced in version 2.4.11. Therefore, the minimum FreeType requirement for Windows builds should be updated to 2.4.11.
I have confirmed that the build succeeds with FreeType 2.4.11 on the same operating systems. Below are the environment details for verification:
Failed Environment (FreeType 2.3.0):

  *   x86: Windows XP SP3, JDK 7u7, Visual Studio 2010, FreeType 2.3.0, Cygwin 1.7.16 (make 3.82.90-1, m4 1.4.16-1, binutils 2.22.51-2, zip 3.0-11, unzip 6.0-10, gawk 4.0.1-1, cpio 2.11-2, procps 3.2.7-1, file 5.11-1)
  *   x64: Windows Server 2003 x64 Enterprise, JDK 7u7, Visual Studio 2010, FreeType 2.3.0, Cygwin 1.7.16 (same components as above)

Successful Environment (FreeType 2.4.11):

  *   x86: Windows XP SP3, JDK 7u7, Visual Studio 2010, FreeType 2.4.11, Cygwin 1.7.16 (same components as above)
  *   x64: Windows Server 2003 x64 Enterprise Edition, JDK 7u7, Visual Studio 2010, FreeType 2.4.11, Cygwin 1.7.16 (same components as above)

Additionally, I note that Windows XP and Server 2003 are outdated systems. Even when the build succeeds with FreeType 2.4.11, jtreg cannot perform full tests on these platforms due to compatibility limitations and socket connection errors (even with the firewall disabled on these operating systems). For a more reliable build and testing workflow, it may be advisable to raise the minimum Windows OS requirements for OpenJDK 8 builds.
I kindly request that the documentation in doc/build.html be updated to reflect the correct minimum FreeType version (2.4.11) for Windows builds. This change will prevent similar issues for other contributors.
Thank you for your time and consideration. I am happy to provide further details if needed.
Best regards,

Neville.

-------------- next part --------------
An HTML attachment was scrubbed...
URL: <https://mail.openjdk.org/pipermail/build-dev/attachments/20251009/da95c254/attachment.htm>