You are viewing a plain text version of this content. The canonical link for it is here.
Posted to common-dev@hadoop.apache.org by Zheng Shao <zs...@facebook.com> on 2008/11/10 23:39:20 UTC

how to debug javadoc warning?

I am getting a javadoc warning in Hudson log (with my patch), but not in my own workspace.

Is there a way to debug javadoc warnings?

     [exec] javadoc:
     [exec]     [mkdir] Created dir: /zonestorage/hudson/home/hudson/hudson/jobs/Hadoop-Patch/workspace/trunk/build/docs/api
     [exec]   [javadoc] Generating Javadoc
     [exec]   [javadoc] Javadoc execution
     [exec]   [javadoc] Loading source files for package org.apache.hadoop...
     [exec]   [javadoc] Loading source files for package org.apache.hadoop.conf...
     [exec]   [javadoc] Loading source files for package org.apache.hadoop.filecache...
...
     [exec]   [javadoc] Loading source files for package org.apache.hadoop.contrib.index.mapred...
     [exec]   [javadoc] Loading source files for package org.apache.hadoop.contrib.failmon...
     [exec]   [javadoc] Constructing Javadoc information...
     [exec]   [javadoc] javadoc: warning - Multiple sources of package comments found for package "org.apache.commons.logging"
     [exec]   [javadoc] javadoc: warning - Multiple sources of package comments found for package "org.apache.commons.logging.impl"
     [exec]   [javadoc] Standard Doclet version 1.6.0_06
     [exec]   [javadoc] Building tree for all the packages and classes...
     [exec]   [javadoc] Building index for all the packages and classes...
     [exec]   [javadoc] Building index for all classes...
     [exec]   [javadoc] Generating /zonestorage/hudson/home/hudson/hudson/jobs/Hadoop-Patch/workspace/trunk/build/docs/api/stylesheet.css...
     [exec]   [javadoc] 2 warnings
     [exec]
     [exec] BUILD SUCCESSFUL
     [exec] Total time: 1 minute 31 seconds
     [exec]
     [exec]
     [exec] There appear to be 1 javadoc warnings generated by the patched build.
     [exec]

Zheng


Re: how to debug javadoc warning?

Posted by "Tsz Wo (Nicholas), Sze" <s2...@yahoo.com>.
Run "ant javadoc" locally.  It is easier to debug.

BTW, the javadoc warnings seem not related to your patch.  See HADOOP-4621.

Nicholas Sze




----- Original Message ----
> From: Zheng Shao <zs...@facebook.com>
> To: "core-dev@hadoop.apache.org" <co...@hadoop.apache.org>
> Cc: Dhruba Borthakur <dh...@facebook.com>
> Sent: Monday, November 10, 2008 2:39:20 PM
> Subject: how to debug javadoc warning?
> 
> I am getting a javadoc warning in Hudson log (with my patch), but not in my own 
> workspace.
> 
> Is there a way to debug javadoc warnings?
> 
>      [exec] javadoc:
>      [exec]     [mkdir] Created dir: 
> /zonestorage/hudson/home/hudson/hudson/jobs/Hadoop-Patch/workspace/trunk/build/docs/api
>      [exec]   [javadoc] Generating Javadoc
>      [exec]   [javadoc] Javadoc execution
>      [exec]   [javadoc] Loading source files for package org.apache.hadoop...
>      [exec]   [javadoc] Loading source files for package 
> org.apache.hadoop.conf...
>      [exec]   [javadoc] Loading source files for package 
> org.apache.hadoop.filecache...
> ...
>      [exec]   [javadoc] Loading source files for package 
> org.apache.hadoop.contrib.index.mapred...
>      [exec]   [javadoc] Loading source files for package 
> org.apache.hadoop.contrib.failmon...
>      [exec]   [javadoc] Constructing Javadoc information...
>      [exec]   [javadoc] javadoc: warning - Multiple sources of package comments 
> found for package "org.apache.commons.logging"
>      [exec]   [javadoc] javadoc: warning - Multiple sources of package comments 
> found for package "org.apache.commons.logging.impl"
>      [exec]   [javadoc] Standard Doclet version 1.6.0_06
>      [exec]   [javadoc] Building tree for all the packages and classes...
>      [exec]   [javadoc] Building index for all the packages and classes...
>      [exec]   [javadoc] Building index for all classes...
>      [exec]   [javadoc] Generating 
> /zonestorage/hudson/home/hudson/hudson/jobs/Hadoop-Patch/workspace/trunk/build/docs/api/stylesheet.css...
>      [exec]   [javadoc] 2 warnings
>      [exec]
>      [exec] BUILD SUCCESSFUL
>      [exec] Total time: 1 minute 31 seconds
>      [exec]
>      [exec]
>      [exec] There appear to be 1 javadoc warnings generated by the patched 
> build.
>      [exec]
> 
> Zheng