[HADOOP-15271] Remove unicode multibyte characters from JavaDoc

• Type: Sub-task
• Status: Resolved
• Priority: Major
• Resolution: Fixed
• Fix Version/s: 3.1.0
• Component/s: documentation

Environment

Java 9.0.4, Applied HADOOP-12760 and HDFS-11610

• Hadoop Flags: Reviewed
• Assignee: Takanobu Asanuma
• Reporter: Akira Ajisaka
• Created: 28/Feb/18 08:26
• Updated: 19/Mar/18 18:32
• Resolved: 05/Mar/18 23:08

Description

mvn package -Pdist,native -Dtar -DskipTests fails.

[ERROR] Failed to execute goal org.apache.maven.plugins:maven-javadoc-plugin:3.0.0-M1:jar (module-javadocs) on project hadoop-common: MavenReportException: Error while generating Javadoc: 
[ERROR] Exit code: 1 - javadoc: warning - The old Doclet and Taglet APIs in the packages
[ERROR] com.sun.javadoc, com.sun.tools.doclets and their implementations
[ERROR] are planned to be removed in a future JDK release. These
[ERROR] components have been superseded by the new APIs in jdk.javadoc.doclet.
[ERROR] Users are strongly recommended to migrate to the new APIs.
[ERROR] /home/centos/git/hadoop/hadoop-common-project/hadoop-common/src/main/java/org/apache/hadoop/fs/FileSystem.java:1652: error: unmappable character (0xE2) for encoding US-ASCII
[ERROR]    * closed automatically ???these the marked paths will be deleted as a result.
[ERROR]                           ^
[ERROR] /home/centos/git/hadoop/hadoop-common-project/hadoop-common/src/main/java/org/apache/hadoop/fs/FileSystem.java:1652: error: unmappable character (0x80) for encoding US-ASCII
[ERROR]    * closed automatically ???these the marked paths will be deleted as a result.
[ERROR]                            ^
[ERROR] /home/centos/git/hadoop/hadoop-common-project/hadoop-common/src/main/java/org/apache/hadoop/fs/FileSystem.java:1652: error: unmappable character (0x94) for encoding US-ASCII
[ERROR]    * closed automatically ???these the marked paths will be deleted as a result.

JDK9 JavaDoc cannot treat non-ascii characters due to https://bugs.openjdk.java.net/browse/JDK-8188649.