[HADOOP-4023] javadoc warnings: incorrect references

• Type: Bug
• Status: Closed
• Priority: Major
• Resolution: Fixed
• Fix Version/s: 0.19.0
• Component/s: documentation
• Hadoop Flags: Reviewed
• Assignee: Owen O'Malley
• Reporter: Tsz-wo Sze
• Created: 26/Aug/08 02:17
• Updated: 20/Nov/08 23:38
• Resolved: 27/Aug/08 02:09

Description

• "ant test-patch" with an empty patch file

    [javadoc] .../trunk/src/core/org/apache/hadoop/fs/FileSystem.java:34: package org.apache.hadoop.hdfs does not exist
    [javadoc] import org.apache.hadoop.hdfs.DistributedFileSystem;
    [javadoc]                              ^
    [javadoc] .../trunk/src/core/org/apache/hadoop/fs/FsShell.java:46: package org.apache.hadoop.hdfs does not exist
    [javadoc] import org.apache.hadoop.hdfs.DistributedFileSystem;
    [javadoc]                              ^
    [javadoc] .../trunk/src/mapred/org/apache/hadoop/mapred/Task.java:36: package org.apache.hadoop.hdfs does not exist
    [javadoc] import org.apache.hadoop.hdfs.DistributedFileSystem;
    [javadoc]                              ^
    [javadoc] Standard Doclet version 1.6.0
    [javadoc] Building tree for all the packages and classes...
    [javadoc] .../trunk/src/core/org/apache/hadoop/fs/FileSystem.java:56: warning - Tag @link: reference not found: DistributedFileSystem
    [javadoc] .../trunk/src/core/org/apache/hadoop/metrics/MetricsUtil.java:34: warning - Tag @link: reference not found: org.apache.hadoop.hdfs.server.namenode.metrics.NameNodeMetrics
    [javadoc] Building index for all the packages and classes...
    [javadoc] Building index for all classes...
    [javadoc] .../trunk/src/core/overview.html: warning - Tag @link: reference not found: org.apache.hadoop.hdfs.server.namenode.NameNode
    [javadoc] Generating /home/tsz/hadoop/trunk/build/docs/api/stylesheet.css...
    [javadoc] 6 warnings
  

• "ant javadoc"

    [javadoc] .../trunk/src/core/org/apache/hadoop/metrics/MetricsUtil.java:34: warning - Tag @link: reference not found: org.apache.hadoop.hdfs.server.namenode.metrics.NameNodeMetrics
    [javadoc] Building index for all the packages and classes...
    [javadoc] Building index for all classes...
    [javadoc] .../trunk/src/core/overview.html: warning - Tag @link: reference not found: org.apache.hadoop.hdfs.server.namenode.NameNode
    [javadoc] Generating .../trunk/build/docs/api/stylesheet.css...
    [javadoc] 2 warnings
  

Issue Links

• relates to: MAPREDUCE-559 Clean up javadoc to reflect the public and private interfaces
• relates to: HADOOP-4024 "ant test-patch" and "ant javadoc" are inconsistent