(kafka) branch trunk updated: KAFKA-21264: Javadoc output language depends on the build machine's system locale (#23789)

[jy...@apache.org]

This is an automated email from the ASF dual-hosted git repository.

m1a2st pushed a commit to branch trunk
in repository https://gitbox.apache.org/repos/asf/kafka.git


The following commit(s) were added to refs/heads/trunk by this push:
     new e4e8654b37d KAFKA-21264: Javadoc output language depends on the build machine's system locale (#23789)
e4e8654b37d is described below

commit e4e8654b37d9e1ba6231852a4e192ed101561152
Author: Russole Chen <54...@users.noreply.github.com>
AuthorDate: Tue Oct 13 09:18:54 2026 +0800

    KAFKA-21264: Javadoc output language depends on the build machine's system locale (#23789)
    
    Javadoc currently inherits the JVM default locale, which can result in
    generated HTML using a different `lang` attribute depending on the build
    environment. Set the Javadoc locale explicitly to English so that
    generated pages consistently use `<html lang="en">`.
    
    Tested with `./gradlew aggregatedJavadoc --no-daemon --console=plain`;
    the build completed successfully and the generated Javadoc pages use
    `<html lang="en">`.
    
    Reviewers: Ken Huang <s7...@gmail.com>
---
 build.gradle | 1 +
 1 file changed, 1 insertion(+)

diff --git a/build.gradle b/build.gradle
index f2bc8d6123c..bad9a4b7a42 100644
--- a/build.gradle
+++ b/build.gradle
@@ -208,6 +208,7 @@ allprojects {
     options.charSet = 'UTF-8'
     options.docEncoding = 'UTF-8'
     options.encoding = 'UTF-8'
+    options.locale = 'en'
     options.memberLevel = JavadocMemberLevel.PUBLIC  // Document only public members/API
     // Turn off doclint for now, see https://blog.joda.org/2014/02/turning-off-doclint-in-jdk-8-javadoc.html for rationale
     options.addStringOption('Xdoclint:none', '-quiet')