[HDFS-15506] [JDK 11] Fix javadoc errors in hadoop-hdfs module

• Type: Bug
• Status: Resolved
• Priority: Major
• Resolution: Fixed
• Affects Version/s: 3.3.1, 3.4.0
• Fix Version/s: 3.3.1, 3.4.0
• Component/s: documentation
• Labels: newbie
• Target Version/s: 3.4.0
• Hadoop Flags: Reviewed
• Assignee: Xieming Li
• Reporter: Akira Ajisaka
• Created: 03/Aug/20 02:37
• Updated: 27/Jan/24 03:15
• Resolved: 11/Aug/20 02:16

Description

[ERROR] /Users/aajisaka/git/hadoop/hadoop-hdfs-project/hadoop-hdfs/src/main/java/org/apache/hadoop/hdfs/server/blockmanagement/DatanodeAdminDefaultMonitor.java:43: error: self-closing element not allowed
[ERROR]  * <p/>
[ERROR]    ^
[ERROR] /Users/aajisaka/git/hadoop/hadoop-hdfs-project/hadoop-hdfs/src/main/java/org/apache/hadoop/hdfs/DFSConfigKeys.java:682: error: malformed HTML
[ERROR]    * a NameNode per second. Values <= 0 disable throttling. This affects
[ERROR]                                    ^
[ERROR] /Users/aajisaka/git/hadoop/hadoop-hdfs-project/hadoop-hdfs/src/main/java/org/apache/hadoop/hdfs/DFSUtil.java:1780: error: exception not thrown: java.io.FileNotFoundException
[ERROR]    * @throws FileNotFoundException
[ERROR]              ^
[ERROR] /Users/aajisaka/git/hadoop/hadoop-hdfs-project/hadoop-hdfs/src/main/java/org/apache/hadoop/hdfs/server/namenode/snapshot/DirectorySnapshottableFeature.java:176: error: @param name not found
[ERROR]    * @param mtime The snapshot creation time set by Time.now().
[ERROR]             ^
[ERROR] /Users/aajisaka/git/hadoop/hadoop-hdfs-project/hadoop-hdfs/src/main/java/org/apache/hadoop/hdfs/tools/DFSAdmin.java:2187: error: exception not thrown: java.lang.Exception
[ERROR]    * @exception Exception if the filesystem does not exist.
[ERROR]                 ^

Full error log: https://gist.github.com/aajisaka/a0c16f0408a623e798dd7df29fbddf82

How to reproduce the failure:

• Remove <javadoc.skip.jdk11>true</javadoc.skip.jdk11> from pom.xml
• Run mvn process-sources javadoc:javadoc-no-fork

Issue Links

• is a child of: HADOOP-16795 Java 11 compile support