You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@nutch.apache.org by "nutch.newbie (JIRA)" <ji...@apache.org> on 2006/10/24 15:59:16 UTC
[jira] Created: (NUTCH-390) Javadoc warnings
Javadoc warnings
----------------
Key: NUTCH-390
URL: http://issues.apache.org/jira/browse/NUTCH-390
Project: Nutch
Issue Type: Bug
Affects Versions: 0.9.0
Environment: Linux Fedora
Reporter: nutch.newbie
Priority: Trivial
Warnings aren't so good even if it build's successfully.
[javadoc] Building tree for all the packages and classes...
[javadoc] /usr/local/src/nutch-0.9/src/java/org/apache/nutch/net/URLNormalizers.java:74: warning - Tag @link: reference not found: org.apache.nutch.net.urlnormalizer.pass.PassURLNormalizer
[javadoc] /usr/local/src/nutch-0.9/src/java/org/apache/nutch/net/URLNormalizers.java:273: warning - @return tag has no arguments.
[javadoc] /usr/local/src/nutch-0.9/src/java/org/apache/nutch/plugin/PluginManifestParser.java:73: warning - @return tag has no arguments.
[javadoc] /usr/local/src/nutch-0.9/src/java/org/apache/nutch/protocol/ProtocolFactory.java:37: warning - Missing closing '}' character for inline tag: "{@link Protocol#X_POINT_ID)."
[javadoc] /usr/local/src/nutch-0.9/src/java/org/apache/nutch/protocol/ProtocolFactory.java:64: warning - @return tag has no arguments.
[javadoc] /usr/local/src/nutch-0.9/src/java/org/apache/nutch/scoring/ScoringFilter.java:139: warning - Tag @param cannot be used in inline documentation. It can only be used in the following types of documentation: class/interface, constructor, method.
[javadoc] /usr/local/src/nutch-0.9/src/java/org/apache/nutch/scoring/ScoringFilter.java:139: warning - Tag @param cannot be used in inline documentation. It can only be used in the following types of documentation: class/interface, constructor, method.
[javadoc] /usr/local/src/nutch-0.9/src/java/org/apache/nutch/util/DomUtil.java:51: warning - @return tag has no arguments.
[javadoc] /usr/local/src/nutch-0.9/src/java/org/apache/nutch/scoring/ScoringFilter.java:139: warning - Tag @param cannot be used in inline documentation. It can only be used in the following types of documentation: class/interface, constructor, method.
[javadoc] Building index for all the packages and classes...
[javadoc] Building index for all classes...
[javadoc] Generating /usr/local/src/nutch-0.9/build/docs/api/stylesheet.css...
[javadoc] 10 warnings
[copy] Copying 1 file to /usr/local/src/nutch-0.9/build/docs/api/org/apache/nutch/plugin/doc-files
--
This message is automatically generated by JIRA.
-
If you think it was sent incorrectly contact one of the administrators: http://issues.apache.org/jira/secure/Administrators.jspa
-
For more information on JIRA, see: http://www.atlassian.com/software/jira
[jira] Assigned: (NUTCH-390) Javadoc warnings
Posted by "Chris A. Mattmann (JIRA)" <ji...@apache.org>.
[ http://issues.apache.org/jira/browse/NUTCH-390?page=all ]
Chris A. Mattmann reassigned NUTCH-390:
---------------------------------------
Assignee: Chris A. Mattmann
> Javadoc warnings
> ----------------
>
> Key: NUTCH-390
> URL: http://issues.apache.org/jira/browse/NUTCH-390
> Project: Nutch
> Issue Type: Bug
> Affects Versions: 0.9.0
> Environment: Linux Fedora
> Reporter: nutch.newbie
> Assigned To: Chris A. Mattmann
> Priority: Trivial
>
> Warnings aren't so good even if it build's successfully.
> [javadoc] Building tree for all the packages and classes...
> [javadoc] /usr/local/src/nutch-0.9/src/java/org/apache/nutch/net/URLNormalizers.java:74: warning - Tag @link: reference not found: org.apache.nutch.net.urlnormalizer.pass.PassURLNormalizer
> [javadoc] /usr/local/src/nutch-0.9/src/java/org/apache/nutch/net/URLNormalizers.java:273: warning - @return tag has no arguments.
> [javadoc] /usr/local/src/nutch-0.9/src/java/org/apache/nutch/plugin/PluginManifestParser.java:73: warning - @return tag has no arguments.
> [javadoc] /usr/local/src/nutch-0.9/src/java/org/apache/nutch/protocol/ProtocolFactory.java:37: warning - Missing closing '}' character for inline tag: "{@link Protocol#X_POINT_ID)."
> [javadoc] /usr/local/src/nutch-0.9/src/java/org/apache/nutch/protocol/ProtocolFactory.java:64: warning - @return tag has no arguments.
> [javadoc] /usr/local/src/nutch-0.9/src/java/org/apache/nutch/scoring/ScoringFilter.java:139: warning - Tag @param cannot be used in inline documentation. It can only be used in the following types of documentation: class/interface, constructor, method.
> [javadoc] /usr/local/src/nutch-0.9/src/java/org/apache/nutch/scoring/ScoringFilter.java:139: warning - Tag @param cannot be used in inline documentation. It can only be used in the following types of documentation: class/interface, constructor, method.
> [javadoc] /usr/local/src/nutch-0.9/src/java/org/apache/nutch/util/DomUtil.java:51: warning - @return tag has no arguments.
> [javadoc] /usr/local/src/nutch-0.9/src/java/org/apache/nutch/scoring/ScoringFilter.java:139: warning - Tag @param cannot be used in inline documentation. It can only be used in the following types of documentation: class/interface, constructor, method.
> [javadoc] Building index for all the packages and classes...
> [javadoc] Building index for all classes...
> [javadoc] Generating /usr/local/src/nutch-0.9/build/docs/api/stylesheet.css...
> [javadoc] 10 warnings
> [copy] Copying 1 file to /usr/local/src/nutch-0.9/build/docs/api/org/apache/nutch/plugin/doc-files
--
This message is automatically generated by JIRA.
-
If you think it was sent incorrectly contact one of the administrators: http://issues.apache.org/jira/secure/Administrators.jspa
-
For more information on JIRA, see: http://www.atlassian.com/software/jira
[jira] Work started: (NUTCH-390) Javadoc warnings
Posted by "Chris A. Mattmann (JIRA)" <ji...@apache.org>.
[ https://issues.apache.org/jira/browse/NUTCH-390?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel ]
Work on NUTCH-390 started by Chris A. Mattmann.
> Javadoc warnings
> ----------------
>
> Key: NUTCH-390
> URL: https://issues.apache.org/jira/browse/NUTCH-390
> Project: Nutch
> Issue Type: Bug
> Affects Versions: 0.9.0
> Environment: Linux Fedora
> Reporter: nutch.newbie
> Assigned To: Chris A. Mattmann
> Priority: Trivial
>
> Warnings aren't so good even if it build's successfully.
> [javadoc] Building tree for all the packages and classes...
> [javadoc] /usr/local/src/nutch-0.9/src/java/org/apache/nutch/net/URLNormalizers.java:74: warning - Tag @link: reference not found: org.apache.nutch.net.urlnormalizer.pass.PassURLNormalizer
> [javadoc] /usr/local/src/nutch-0.9/src/java/org/apache/nutch/net/URLNormalizers.java:273: warning - @return tag has no arguments.
> [javadoc] /usr/local/src/nutch-0.9/src/java/org/apache/nutch/plugin/PluginManifestParser.java:73: warning - @return tag has no arguments.
> [javadoc] /usr/local/src/nutch-0.9/src/java/org/apache/nutch/protocol/ProtocolFactory.java:37: warning - Missing closing '}' character for inline tag: "{@link Protocol#X_POINT_ID)."
> [javadoc] /usr/local/src/nutch-0.9/src/java/org/apache/nutch/protocol/ProtocolFactory.java:64: warning - @return tag has no arguments.
> [javadoc] /usr/local/src/nutch-0.9/src/java/org/apache/nutch/scoring/ScoringFilter.java:139: warning - Tag @param cannot be used in inline documentation. It can only be used in the following types of documentation: class/interface, constructor, method.
> [javadoc] /usr/local/src/nutch-0.9/src/java/org/apache/nutch/scoring/ScoringFilter.java:139: warning - Tag @param cannot be used in inline documentation. It can only be used in the following types of documentation: class/interface, constructor, method.
> [javadoc] /usr/local/src/nutch-0.9/src/java/org/apache/nutch/util/DomUtil.java:51: warning - @return tag has no arguments.
> [javadoc] /usr/local/src/nutch-0.9/src/java/org/apache/nutch/scoring/ScoringFilter.java:139: warning - Tag @param cannot be used in inline documentation. It can only be used in the following types of documentation: class/interface, constructor, method.
> [javadoc] Building index for all the packages and classes...
> [javadoc] Building index for all classes...
> [javadoc] Generating /usr/local/src/nutch-0.9/build/docs/api/stylesheet.css...
> [javadoc] 10 warnings
> [copy] Copying 1 file to /usr/local/src/nutch-0.9/build/docs/api/org/apache/nutch/plugin/doc-files
--
This message is automatically generated by JIRA.
-
You can reply to this email to add a comment to the issue online.
[jira] Commented: (NUTCH-390) Javadoc warnings
Posted by "nutch.newbie (JIRA)" <ji...@apache.org>.
[ http://issues.apache.org/jira/browse/NUTCH-390?page=comments#action_12452552 ]
nutch.newbie commented on NUTCH-390:
------------------------------------
and some more cleanup that comes with building plugins.....
[javac] Note: Some input files use unchecked or unsafe operations.
[javac] Note: Recompile with -Xlint:unchecked for details
its just confusing nothing more.
regards
> Javadoc warnings
> ----------------
>
> Key: NUTCH-390
> URL: http://issues.apache.org/jira/browse/NUTCH-390
> Project: Nutch
> Issue Type: Bug
> Affects Versions: 0.9.0
> Environment: Linux Fedora
> Reporter: nutch.newbie
> Assigned To: Chris A. Mattmann
> Priority: Trivial
>
> Warnings aren't so good even if it build's successfully.
> [javadoc] Building tree for all the packages and classes...
> [javadoc] /usr/local/src/nutch-0.9/src/java/org/apache/nutch/net/URLNormalizers.java:74: warning - Tag @link: reference not found: org.apache.nutch.net.urlnormalizer.pass.PassURLNormalizer
> [javadoc] /usr/local/src/nutch-0.9/src/java/org/apache/nutch/net/URLNormalizers.java:273: warning - @return tag has no arguments.
> [javadoc] /usr/local/src/nutch-0.9/src/java/org/apache/nutch/plugin/PluginManifestParser.java:73: warning - @return tag has no arguments.
> [javadoc] /usr/local/src/nutch-0.9/src/java/org/apache/nutch/protocol/ProtocolFactory.java:37: warning - Missing closing '}' character for inline tag: "{@link Protocol#X_POINT_ID)."
> [javadoc] /usr/local/src/nutch-0.9/src/java/org/apache/nutch/protocol/ProtocolFactory.java:64: warning - @return tag has no arguments.
> [javadoc] /usr/local/src/nutch-0.9/src/java/org/apache/nutch/scoring/ScoringFilter.java:139: warning - Tag @param cannot be used in inline documentation. It can only be used in the following types of documentation: class/interface, constructor, method.
> [javadoc] /usr/local/src/nutch-0.9/src/java/org/apache/nutch/scoring/ScoringFilter.java:139: warning - Tag @param cannot be used in inline documentation. It can only be used in the following types of documentation: class/interface, constructor, method.
> [javadoc] /usr/local/src/nutch-0.9/src/java/org/apache/nutch/util/DomUtil.java:51: warning - @return tag has no arguments.
> [javadoc] /usr/local/src/nutch-0.9/src/java/org/apache/nutch/scoring/ScoringFilter.java:139: warning - Tag @param cannot be used in inline documentation. It can only be used in the following types of documentation: class/interface, constructor, method.
> [javadoc] Building index for all the packages and classes...
> [javadoc] Building index for all classes...
> [javadoc] Generating /usr/local/src/nutch-0.9/build/docs/api/stylesheet.css...
> [javadoc] 10 warnings
> [copy] Copying 1 file to /usr/local/src/nutch-0.9/build/docs/api/org/apache/nutch/plugin/doc-files
--
This message is automatically generated by JIRA.
-
If you think it was sent incorrectly contact one of the administrators: http://issues.apache.org/jira/secure/Administrators.jspa
-
For more information on JIRA, see: http://www.atlassian.com/software/jira
[jira] Resolved: (NUTCH-390) Javadoc warnings
Posted by "Chris A. Mattmann (JIRA)" <ji...@apache.org>.
[ https://issues.apache.org/jira/browse/NUTCH-390?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel ]
Chris A. Mattmann resolved NUTCH-390.
-------------------------------------
Resolution: Fixed
Fix Version/s: 0.9.0
I've fixed this issue in the trunk. I had to modify the existing commons-logging-1.4.0 and 1.3.0 jars within nutch/lib and within nutch/src/plugin/ontology/lib. Turns out that if you include the package.html file within the jar file, Javadoc gets confused as to which one it should use. That was the only real gotcha. This should address *all* the javadoc warnings that were being generated.
> Javadoc warnings
> ----------------
>
> Key: NUTCH-390
> URL: https://issues.apache.org/jira/browse/NUTCH-390
> Project: Nutch
> Issue Type: Bug
> Affects Versions: 0.9.0
> Environment: Linux Fedora
> Reporter: nutch.newbie
> Assigned To: Chris A. Mattmann
> Priority: Trivial
> Fix For: 0.9.0
>
>
> Warnings aren't so good even if it build's successfully.
> [javadoc] Building tree for all the packages and classes...
> [javadoc] /usr/local/src/nutch-0.9/src/java/org/apache/nutch/net/URLNormalizers.java:74: warning - Tag @link: reference not found: org.apache.nutch.net.urlnormalizer.pass.PassURLNormalizer
> [javadoc] /usr/local/src/nutch-0.9/src/java/org/apache/nutch/net/URLNormalizers.java:273: warning - @return tag has no arguments.
> [javadoc] /usr/local/src/nutch-0.9/src/java/org/apache/nutch/plugin/PluginManifestParser.java:73: warning - @return tag has no arguments.
> [javadoc] /usr/local/src/nutch-0.9/src/java/org/apache/nutch/protocol/ProtocolFactory.java:37: warning - Missing closing '}' character for inline tag: "{@link Protocol#X_POINT_ID)."
> [javadoc] /usr/local/src/nutch-0.9/src/java/org/apache/nutch/protocol/ProtocolFactory.java:64: warning - @return tag has no arguments.
> [javadoc] /usr/local/src/nutch-0.9/src/java/org/apache/nutch/scoring/ScoringFilter.java:139: warning - Tag @param cannot be used in inline documentation. It can only be used in the following types of documentation: class/interface, constructor, method.
> [javadoc] /usr/local/src/nutch-0.9/src/java/org/apache/nutch/scoring/ScoringFilter.java:139: warning - Tag @param cannot be used in inline documentation. It can only be used in the following types of documentation: class/interface, constructor, method.
> [javadoc] /usr/local/src/nutch-0.9/src/java/org/apache/nutch/util/DomUtil.java:51: warning - @return tag has no arguments.
> [javadoc] /usr/local/src/nutch-0.9/src/java/org/apache/nutch/scoring/ScoringFilter.java:139: warning - Tag @param cannot be used in inline documentation. It can only be used in the following types of documentation: class/interface, constructor, method.
> [javadoc] Building index for all the packages and classes...
> [javadoc] Building index for all classes...
> [javadoc] Generating /usr/local/src/nutch-0.9/build/docs/api/stylesheet.css...
> [javadoc] 10 warnings
> [copy] Copying 1 file to /usr/local/src/nutch-0.9/build/docs/api/org/apache/nutch/plugin/doc-files
--
This message is automatically generated by JIRA.
-
You can reply to this email to add a comment to the issue online.
[jira] Closed: (NUTCH-390) Javadoc warnings
Posted by "Chris A. Mattmann (JIRA)" <ji...@apache.org>.
[ https://issues.apache.org/jira/browse/NUTCH-390?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel ]
Chris A. Mattmann closed NUTCH-390.
-----------------------------------
Fixed in the trunk:
http://svn.apache.org/viewvc?view=rev&revision=501315
> Javadoc warnings
> ----------------
>
> Key: NUTCH-390
> URL: https://issues.apache.org/jira/browse/NUTCH-390
> Project: Nutch
> Issue Type: Bug
> Affects Versions: 0.9.0
> Environment: Linux Fedora
> Reporter: nutch.newbie
> Assigned To: Chris A. Mattmann
> Priority: Trivial
> Fix For: 0.9.0
>
>
> Warnings aren't so good even if it build's successfully.
> [javadoc] Building tree for all the packages and classes...
> [javadoc] /usr/local/src/nutch-0.9/src/java/org/apache/nutch/net/URLNormalizers.java:74: warning - Tag @link: reference not found: org.apache.nutch.net.urlnormalizer.pass.PassURLNormalizer
> [javadoc] /usr/local/src/nutch-0.9/src/java/org/apache/nutch/net/URLNormalizers.java:273: warning - @return tag has no arguments.
> [javadoc] /usr/local/src/nutch-0.9/src/java/org/apache/nutch/plugin/PluginManifestParser.java:73: warning - @return tag has no arguments.
> [javadoc] /usr/local/src/nutch-0.9/src/java/org/apache/nutch/protocol/ProtocolFactory.java:37: warning - Missing closing '}' character for inline tag: "{@link Protocol#X_POINT_ID)."
> [javadoc] /usr/local/src/nutch-0.9/src/java/org/apache/nutch/protocol/ProtocolFactory.java:64: warning - @return tag has no arguments.
> [javadoc] /usr/local/src/nutch-0.9/src/java/org/apache/nutch/scoring/ScoringFilter.java:139: warning - Tag @param cannot be used in inline documentation. It can only be used in the following types of documentation: class/interface, constructor, method.
> [javadoc] /usr/local/src/nutch-0.9/src/java/org/apache/nutch/scoring/ScoringFilter.java:139: warning - Tag @param cannot be used in inline documentation. It can only be used in the following types of documentation: class/interface, constructor, method.
> [javadoc] /usr/local/src/nutch-0.9/src/java/org/apache/nutch/util/DomUtil.java:51: warning - @return tag has no arguments.
> [javadoc] /usr/local/src/nutch-0.9/src/java/org/apache/nutch/scoring/ScoringFilter.java:139: warning - Tag @param cannot be used in inline documentation. It can only be used in the following types of documentation: class/interface, constructor, method.
> [javadoc] Building index for all the packages and classes...
> [javadoc] Building index for all classes...
> [javadoc] Generating /usr/local/src/nutch-0.9/build/docs/api/stylesheet.css...
> [javadoc] 10 warnings
> [copy] Copying 1 file to /usr/local/src/nutch-0.9/build/docs/api/org/apache/nutch/plugin/doc-files
--
This message is automatically generated by JIRA.
-
You can reply to this email to add a comment to the issue online.