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 "Konstantin Shvachko (JIRA)" <ji...@apache.org> on 2007/05/02 01:38:15 UTC

[jira] Created: (HADOOP-1314) JavaDoc warnings in HDFS

JavaDoc warnings in HDFS
------------------------

                 Key: HADOOP-1314
                 URL: https://issues.apache.org/jira/browse/HADOOP-1314
             Project: Hadoop
          Issue Type: Improvement
          Components: dfs
    Affects Versions: 0.12.3
            Reporter: Konstantin Shvachko
         Assigned To: dhruba borthakur
            Priority: Minor
             Fix For: 0.13.0


src\java\org\apache\hadoop\dfs\FSNamesystem.java:3136: warning - @param argument "replication" is not a parameter name.
src\java\org\apache\hadoop\dfs\FSNamesystem.java:2855: warning - Tag @link: reference not found: blocksMap
src\java\org\apache\hadoop\dfs\ReplicationTargetChooser.java:67: warning - @param argument "numOfReplicas:" is not a parameter name.
src\java\org\apache\hadoop\dfs\ReplicationTargetChooser.java:67: warning - @param argument "writer:" is not a parameter name.
src\java\org\apache\hadoop\dfs\ReplicationTargetChooser.java:67: warning - @param argument "excludedNodes:" is not a parameter name.
src\java\org\apache\hadoop\dfs\ReplicationTargetChooser.java:67: warning - @param argument "blocksize:" is not a parameter name.
src\java\org\apache\hadoop\dfs\ReplicationTargetChooser.java:92: warning - @param argument "numOfReplicas:" is not a parameter name.
src\java\org\apache\hadoop\dfs\ReplicationTargetChooser.java:92: warning - @param argument "writer:" is not a parameter name.
src\java\org\apache\hadoop\dfs\ReplicationTargetChooser.java:92: warning - @param argument "choosenNodes:" is not a parameter name.
src\java\org\apache\hadoop\dfs\ReplicationTargetChooser.java:92: warning - @param argument "excludedNodes:" is not a parameter name.
src\java\org\apache\hadoop\dfs\ReplicationTargetChooser.java:92: warning - @param argument "blocksize:" is not a parameter name.


-- 
This message is automatically generated by JIRA.
-
You can reply to this email to add a comment to the issue online.


[jira] Commented: (HADOOP-1314) JavaDoc warnings in HDFS

Posted by "Konstantin Shvachko (JIRA)" <ji...@apache.org>.
    [ https://issues.apache.org/jira/browse/HADOOP-1314?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel#action_12494383 ] 

Konstantin Shvachko commented on HADOOP-1314:
---------------------------------------------

Current trunk warnings confirmed.
"ant package" checks JavaDoc for public classes only. Those are not public, but they need to be correct too imo.
I generate JavaDoc using eclipse, where you can specify which classes need to be included.
There is actually more warnings, e.g. FsShell has 20 of them. I just listed the new ones.

> JavaDoc warnings in HDFS
> ------------------------
>
>                 Key: HADOOP-1314
>                 URL: https://issues.apache.org/jira/browse/HADOOP-1314
>             Project: Hadoop
>          Issue Type: Improvement
>          Components: dfs
>    Affects Versions: 0.12.3
>            Reporter: Konstantin Shvachko
>         Assigned To: dhruba borthakur
>            Priority: Minor
>             Fix For: 0.13.0
>
>
> src\java\org\apache\hadoop\dfs\FSNamesystem.java:3136: warning - @param argument "replication" is not a parameter name.
> src\java\org\apache\hadoop\dfs\FSNamesystem.java:2855: warning - Tag @link: reference not found: blocksMap
> src\java\org\apache\hadoop\dfs\ReplicationTargetChooser.java:67: warning - @param argument "numOfReplicas:" is not a parameter name.
> src\java\org\apache\hadoop\dfs\ReplicationTargetChooser.java:67: warning - @param argument "writer:" is not a parameter name.
> src\java\org\apache\hadoop\dfs\ReplicationTargetChooser.java:67: warning - @param argument "excludedNodes:" is not a parameter name.
> src\java\org\apache\hadoop\dfs\ReplicationTargetChooser.java:67: warning - @param argument "blocksize:" is not a parameter name.
> src\java\org\apache\hadoop\dfs\ReplicationTargetChooser.java:92: warning - @param argument "numOfReplicas:" is not a parameter name.
> src\java\org\apache\hadoop\dfs\ReplicationTargetChooser.java:92: warning - @param argument "writer:" is not a parameter name.
> src\java\org\apache\hadoop\dfs\ReplicationTargetChooser.java:92: warning - @param argument "choosenNodes:" is not a parameter name.
> src\java\org\apache\hadoop\dfs\ReplicationTargetChooser.java:92: warning - @param argument "excludedNodes:" is not a parameter name.
> src\java\org\apache\hadoop\dfs\ReplicationTargetChooser.java:92: warning - @param argument "blocksize:" is not a parameter name.

-- 
This message is automatically generated by JIRA.
-
You can reply to this email to add a comment to the issue online.


[jira] Commented: (HADOOP-1314) JavaDoc warnings in HDFS

Posted by "dhruba borthakur (JIRA)" <ji...@apache.org>.
    [ https://issues.apache.org/jira/browse/HADOOP-1314?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel#action_12494372 ] 

dhruba borthakur commented on HADOOP-1314:
------------------------------------------

I ran an "ant package" to create the javadocs and I do not see the warnings that you mentioned. It is very likely that you had an inconsistent workspace. Please let me know if you are still seeing these problems with latest trunk. Thanks. 

> JavaDoc warnings in HDFS
> ------------------------
>
>                 Key: HADOOP-1314
>                 URL: https://issues.apache.org/jira/browse/HADOOP-1314
>             Project: Hadoop
>          Issue Type: Improvement
>          Components: dfs
>    Affects Versions: 0.12.3
>            Reporter: Konstantin Shvachko
>         Assigned To: dhruba borthakur
>            Priority: Minor
>             Fix For: 0.13.0
>
>
> src\java\org\apache\hadoop\dfs\FSNamesystem.java:3136: warning - @param argument "replication" is not a parameter name.
> src\java\org\apache\hadoop\dfs\FSNamesystem.java:2855: warning - Tag @link: reference not found: blocksMap
> src\java\org\apache\hadoop\dfs\ReplicationTargetChooser.java:67: warning - @param argument "numOfReplicas:" is not a parameter name.
> src\java\org\apache\hadoop\dfs\ReplicationTargetChooser.java:67: warning - @param argument "writer:" is not a parameter name.
> src\java\org\apache\hadoop\dfs\ReplicationTargetChooser.java:67: warning - @param argument "excludedNodes:" is not a parameter name.
> src\java\org\apache\hadoop\dfs\ReplicationTargetChooser.java:67: warning - @param argument "blocksize:" is not a parameter name.
> src\java\org\apache\hadoop\dfs\ReplicationTargetChooser.java:92: warning - @param argument "numOfReplicas:" is not a parameter name.
> src\java\org\apache\hadoop\dfs\ReplicationTargetChooser.java:92: warning - @param argument "writer:" is not a parameter name.
> src\java\org\apache\hadoop\dfs\ReplicationTargetChooser.java:92: warning - @param argument "choosenNodes:" is not a parameter name.
> src\java\org\apache\hadoop\dfs\ReplicationTargetChooser.java:92: warning - @param argument "excludedNodes:" is not a parameter name.
> src\java\org\apache\hadoop\dfs\ReplicationTargetChooser.java:92: warning - @param argument "blocksize:" is not a parameter name.

-- 
This message is automatically generated by JIRA.
-
You can reply to this email to add a comment to the issue online.


[jira] Commented: (HADOOP-1314) JavaDoc warnings in HDFS

Posted by "Konstantin Shvachko (JIRA)" <ji...@apache.org>.
    [ https://issues.apache.org/jira/browse/HADOOP-1314?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel#action_12492985 ] 

Konstantin Shvachko commented on HADOOP-1314:
---------------------------------------------

src\java\org\apache\hadoop\dfs\DFSClient.java:403: warning - Tag @see: can't find metaSave() in org.apache.hadoop.dfs.ClientProtocol
src\java\org\apache\hadoop\dfs\DFSClient.java:403: warning - Tag @link: can't find metaSave() in org.apache.hadoop.dfs.ClientProtocol


> JavaDoc warnings in HDFS
> ------------------------
>
>                 Key: HADOOP-1314
>                 URL: https://issues.apache.org/jira/browse/HADOOP-1314
>             Project: Hadoop
>          Issue Type: Improvement
>          Components: dfs
>    Affects Versions: 0.12.3
>            Reporter: Konstantin Shvachko
>         Assigned To: dhruba borthakur
>            Priority: Minor
>             Fix For: 0.13.0
>
>
> src\java\org\apache\hadoop\dfs\FSNamesystem.java:3136: warning - @param argument "replication" is not a parameter name.
> src\java\org\apache\hadoop\dfs\FSNamesystem.java:2855: warning - Tag @link: reference not found: blocksMap
> src\java\org\apache\hadoop\dfs\ReplicationTargetChooser.java:67: warning - @param argument "numOfReplicas:" is not a parameter name.
> src\java\org\apache\hadoop\dfs\ReplicationTargetChooser.java:67: warning - @param argument "writer:" is not a parameter name.
> src\java\org\apache\hadoop\dfs\ReplicationTargetChooser.java:67: warning - @param argument "excludedNodes:" is not a parameter name.
> src\java\org\apache\hadoop\dfs\ReplicationTargetChooser.java:67: warning - @param argument "blocksize:" is not a parameter name.
> src\java\org\apache\hadoop\dfs\ReplicationTargetChooser.java:92: warning - @param argument "numOfReplicas:" is not a parameter name.
> src\java\org\apache\hadoop\dfs\ReplicationTargetChooser.java:92: warning - @param argument "writer:" is not a parameter name.
> src\java\org\apache\hadoop\dfs\ReplicationTargetChooser.java:92: warning - @param argument "choosenNodes:" is not a parameter name.
> src\java\org\apache\hadoop\dfs\ReplicationTargetChooser.java:92: warning - @param argument "excludedNodes:" is not a parameter name.
> src\java\org\apache\hadoop\dfs\ReplicationTargetChooser.java:92: warning - @param argument "blocksize:" is not a parameter name.

-- 
This message is automatically generated by JIRA.
-
You can reply to this email to add a comment to the issue online.