[
https://issues.apache.org/jira/browse/HADOOP-11292?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=14205338#comment-14205338
]
Chen He commented on HADOOP-11292:
----------------------------------
There are some rules like :
no self-closed HTML tags, such as <br /> or <a id="x" />
no unclosed HTML tags, such as <ul> without matching </ul>
no invalid HTML end tags, such as </br>
no invalid HTML attributes, based on doclint's interpretation of W3C HTML 4.01
no duplicate HTML id attribute
no empty HTML href attribute
no incorrectly nested headers, such as class documentation must have <h3>, not
<h4>
no invalid HTML tags, such as List<String> (where you forgot to escape using
<)
no broken @link references
no broken @param references, they must match the actual parameter name
no broken @throws references, the first word must be a class name
...... etc.
> "mvm package" reports error when using Java 1.8
> ------------------------------------------------
>
> Key: HADOOP-11292
> URL: https://issues.apache.org/jira/browse/HADOOP-11292
> Project: Hadoop Common
> Issue Type: Bug
> Reporter: Chen He
> Assignee: Chen He
> Attachments: HADOOP-11292.patch
>
>
> mvn package -Pdist -Dtar -DskipTests" reports following error based on latest
> trunk:
> [INFO] BUILD FAILURE
> [INFO]
> ------------------------------------------------------------------------
> [INFO] Total time: 11.010 s
> [INFO] Finished at: 2014-11-10T11:23:49-08:00
> [INFO] Final Memory: 51M/555M
> [INFO]
> ------------------------------------------------------------------------
> [ERROR] Failed to execute goal
> org.apache.maven.plugins:maven-javadoc-plugin:2.8.1:jar (module-javadocs) on
> project hadoop-maven-plugins: MavenReportException: Error while creating
> archive:
> [ERROR] Exit code: 1 -
> ./hadoop/hadoop/hadoop-maven-plugins/src/main/java/org/apache/hadoop/maven/plugin/util/Exec.java:45:
> error: unknown tag: String
> [ERROR] * @param command List<String> containing command and all arguments
> [ERROR] ^
> [ERROR]
> ./develop/hadoop/hadoop/hadoop-maven-plugins/src/main/java/org/apache/hadoop/maven/plugin/util/Exec.java:46:
> error: unknown tag: String
> [ERROR] * @param output List<String> in/out parameter to receive command
> output
> [ERROR] ^
> [ERROR]
> ./hadoop/hadoop/hadoop-maven-plugins/src/main/java/org/apache/hadoop/maven/plugin/util/FileSetUtils.java:50:
> error: unknown tag: File
> [ERROR] * @return List<File> containing every element of the FileSet as a File
> [ERROR] ^
> [ERROR]
> [ERROR] Command line was:
> /Library/Java/JavaVirtualMachines/jdk1.8.0_25.jdk/Contents/Home/bin/javadoc
> -J-Dhttp.proxySet=true -J-Dhttp.proxyHost=www-proxy.us.oracle.com
> -J-Dhttp.proxyPort=80 @options @packages
> [ERROR]
> [ERROR] Refer to the generated Javadoc files in
> './hadoop/hadoop/hadoop-maven-plugins/target' dir.
> [ERROR] -> [Help 1]
> [ERROR]
> [ERROR] To see the full stack trace of the errors, re-run Maven with the -e
> switch.
> [ERROR] Re-run Maven using the -X switch to enable full debug logging.
> [ERROR]
> [ERROR] For more information about the errors and possible solutions, please
> read the following articles:
> [ERROR] [Help 1]
> http://cwiki.apache.org/confluence/display/MAVEN/MojoExecutionException
> [ERROR]
> [ERROR] After correcting the problems, you can resume the build with the
> command
> [ERROR] mvn <goals> -rf :hadoop-maven-plugins
--
This message was sent by Atlassian JIRA
(v6.3.4#6332)
