<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=gb2312">
<style type="text/css" style="display:none;"> P {margin-top:0;margin-bottom:0;} </style>
</head>
<body dir="ltr">
<div style="text-align: left; text-indent: 0px; line-height: 28px; white-space: pre-wrap; margin: 1em 0px; font-family: Aptos, Aptos_EmbeddedFont, Aptos_MSFontService, Calibri, Helvetica, sans-serif; font-size: 12pt; color: rgb(0, 0, 0);" class="elementToProof">
Dear OpenJDK Build Team,</div>
<div style="text-align: left; text-indent: 0px; line-height: 28px; white-space: pre-wrap; margin: 1em 0px; font-family: Aptos, Aptos_EmbeddedFont, Aptos_MSFontService, Calibri, Helvetica, sans-serif; font-size: 12pt; color: rgb(0, 0, 0);" class="elementToProof">
I am writing to report an issue with the build documentation for OpenJDK 8. The current documentation in
<code style="font-family: ui-monospace, SFMono-Regular, "SF Mono", Menlo, Consolas, "Liberation Mono", monospace;">
doc/build.html</code> 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 <code style="font-family: ui-monospace, SFMono-Regular, "SF Mono", Menlo, Consolas, "Liberation Mono", monospace;">
_FT_Property_Set</code> and <code style="font-family: ui-monospace, SFMono-Regular, "SF Mono", Menlo, Consolas, "Liberation Mono", monospace;">
_FT_Library_SetLcdFilter</code> when using FreeType 2.3.0.</div>
<div style="text-align: left; text-indent: 0px; line-height: 28px; white-space: pre-wrap; margin: 1em 0px; font-size: 12pt;" class="elementToProof">
<span style="font-family: Aptos, Aptos_EmbeddedFont, Aptos_MSFontService, Calibri, Helvetica, sans-serif; color: rgb(0, 0, 0);">After investigating the source code, I found that these functions are used in
<code style="font-family: ui-monospace, SFMono-Regular, "SF Mono", Menlo, Consolas, "Liberation Mono", monospace;">
jdk/src/share/native/sun/font/freetypeScaler.c</code> at line 283. According to the FreeType documentation, the symbol
</span><span style="font-family: ui-monospace, SFMono-Regular, "SF Mono", Menlo, Consolas, "Liberation Mono", monospace; color: rgb(0, 0, 0);"><code style="font-family: ui-monospace, SFMono-Regular, "SF Mono", Menlo, Consolas, "Liberation Mono", monospace;">_FT_Property_Set</code> </span><span style="font-family: Aptos, Aptos_EmbeddedFont, Aptos_MSFontService, Calibri, Helvetica, sans-serif; color: rgb(0, 0, 0);">was
introduced in version 2.4.11. Therefore, the minimum FreeType requirement for Windows builds should be updated to 2.4.11.
</span></div>
<div style="text-align: left; text-indent: 0px; line-height: 28px; white-space: pre-wrap; margin: 1em 0px; font-family: Aptos, Aptos_EmbeddedFont, Aptos_MSFontService, Calibri, Helvetica, sans-serif; font-size: 12pt; color: rgb(0, 0, 0);" class="elementToProof">
I have confirmed that the build succeeds with FreeType 2.4.11 on the same operating systems. Below are the environment details for verification:</div>
<div style="text-align: left; text-indent: 0px; line-height: 28px; white-space: pre-wrap; margin: 1em 0px; font-family: Aptos, Aptos_EmbeddedFont, Aptos_MSFontService, Calibri, Helvetica, sans-serif; font-size: 12pt; color: rgb(0, 0, 0);" class="elementToProof">
<span style="font-weight: 600;">Failed Environment (FreeType 2.3.0):</span></div>
<ul style="text-align: left; margin: 1em 0px 1em -12px; padding-left: 2em; list-style-position: initial; list-style-type: none;">
<li style="font-family: Aptos, Aptos_EmbeddedFont, Aptos_MSFontService, Calibri, Helvetica, sans-serif; font-size: 12pt; color: rgb(0, 0, 0); margin: 0.5em 0px; list-style-type: disc;" class="elementToProof">
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)</li><li style="font-family: Aptos, Aptos_EmbeddedFont, Aptos_MSFontService, Calibri, Helvetica, sans-serif; font-size: 12pt; color: rgb(0, 0, 0); margin: 0.5em 0px; list-style-type: disc;" class="elementToProof">
x64: Windows Server 2003 x64 Enterprise, JDK 7u7, Visual Studio 2010, FreeType 2.3.0, Cygwin 1.7.16 (same components as above)</li></ul>
<div style="text-align: left; text-indent: 0px; line-height: 28px; white-space: pre-wrap; margin: 1em 0px; font-family: Aptos, Aptos_EmbeddedFont, Aptos_MSFontService, Calibri, Helvetica, sans-serif; font-size: 12pt; color: rgb(0, 0, 0);" class="elementToProof">
<span style="font-weight: 600;">Successful Environment (FreeType 2.4.11):</span></div>
<ul style="text-align: left; margin: 1em 0px 1em -12px; padding-left: 2em; list-style-position: initial; list-style-type: none;">
<li style="font-family: Aptos, Aptos_EmbeddedFont, Aptos_MSFontService, Calibri, Helvetica, sans-serif; font-size: 12pt; color: rgb(0, 0, 0); margin: 0.5em 0px; list-style-type: disc;" class="elementToProof">
x86: Windows XP SP3, JDK 7u7, Visual Studio 2010, FreeType 2.4.11, Cygwin 1.7.16 (same components as above)</li><li style="font-family: Aptos, Aptos_EmbeddedFont, Aptos_MSFontService, Calibri, Helvetica, sans-serif; font-size: 12pt; color: rgb(0, 0, 0); margin: 0.5em 0px; list-style-type: disc;" class="elementToProof">
x64: Windows Server 2003 x64 Enterprise Edition, JDK 7u7, Visual Studio 2010, FreeType 2.4.11, Cygwin 1.7.16 (same components as above)</li></ul>
<div style="text-align: left; text-indent: 0px; line-height: 28px; white-space: pre-wrap; margin: 1em 0px; font-family: Aptos, Aptos_EmbeddedFont, Aptos_MSFontService, Calibri, Helvetica, sans-serif; font-size: 12pt; color: rgb(0, 0, 0);" class="elementToProof">
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.</div>
<div style="text-align: left; text-indent: 0px; line-height: 28px; white-space: pre-wrap; margin: 1em 0px; font-family: Aptos, Aptos_EmbeddedFont, Aptos_MSFontService, Calibri, Helvetica, sans-serif; font-size: 12pt; color: rgb(0, 0, 0);" class="elementToProof">
I kindly request that the documentation in <code style="font-family: ui-monospace, SFMono-Regular, "SF Mono", Menlo, Consolas, "Liberation Mono", monospace;">
doc/build.html</code> be updated to reflect the correct minimum FreeType version (2.4.11) for Windows builds. This change will prevent similar issues for other contributors.</div>
<div style="text-align: left; text-indent: 0px; line-height: 28px; white-space: pre-wrap; margin: 1em 0px; font-family: Aptos, Aptos_EmbeddedFont, Aptos_MSFontService, Calibri, Helvetica, sans-serif; font-size: 12pt; color: rgb(0, 0, 0);" class="elementToProof">
Thank you for your time and consideration. I am happy to provide further details if needed.</div>
<div style="text-align: left; text-indent: 0px; line-height: 28px; white-space: pre-wrap; margin: 1em 0px 0px; font-family: Aptos, Aptos_EmbeddedFont, Aptos_MSFontService, Calibri, Helvetica, sans-serif; font-size: 12pt; color: rgb(0, 0, 0);" class="elementToProof">
Best regards,</div>
<div style="text-align: left; text-indent: 0px; line-height: 28px; white-space: pre-wrap; margin: 1em 0px; font-family: Aptos, Aptos_EmbeddedFont, Aptos_MSFontService, Calibri, Helvetica, sans-serif; font-size: 12pt; color: rgb(0, 0, 0);" class="elementToProof">
<br>
Neville.</div>
<div style="font-family: Aptos, Aptos_EmbeddedFont, Aptos_MSFontService, Calibri, Helvetica, sans-serif; font-size: 12pt; color: rgb(0, 0, 0);" class="elementToProof">
<br>
</div>
</body>
</html>