[
https://issues.apache.org/jira/browse/LENS-493?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=14587945#comment-14587945
]
Raghavendra Singh commented on LENS-493:
----------------------------------------
generate javadoc is failing in java 7 after adding this param
error:-
Exit code: 1 - javadoc: error - invalid flag: -Xdoclint:none
{noformat}
[INFO]
usage: javadoc [options] [packagenames] [sourcefiles] [@files]
-overview <file> Read overview documentation from HTML file
-public Show only public classes and members
-protected Show protected/public classes and members (default)
-package Show package/protected/public classes and members
-private Show all classes and members
-help Display command line options and exit
-doclet <class> Generate output via alternate doclet
-docletpath <path> Specify where to find doclet class files
-sourcepath <pathlist> Specify where to find source files
-classpath <pathlist> Specify where to find user class files
-exclude <pkglist> Specify a list of packages to exclude
-subpackages <subpkglist> Specify subpackages to recursively load
-breakiterator Compute 1st sentence with BreakIterator
-bootclasspath <pathlist> Override location of class files loaded
by the bootstrap class loader
-source <release> Provide source compatibility with specified release
-extdirs <dirlist> Override location of installed extensions
-verbose Output messages about what Javadoc is doing
-locale <name> Locale to be used, e.g. en_US or en_US_WIN
-encoding <name> Source file encoding name
-quiet Do not display status messages
-J<flag> Pass <flag> directly to the runtime system
-X Print a synopsis of nonstandard options
Provided by Standard doclet:
-d <directory> Destination directory for output files
-use Create class and package usage pages
-version Include @version paragraphs
-author Include @author paragraphs
-docfilessubdirs Recursively copy doc-file subdirectories
-splitindex Split index into one file per letter
-windowtitle <text> Browser window title for the documenation
-doctitle <html-code> Include title for the overview page
-header <html-code> Include header text for each page
-footer <html-code> Include footer text for each page
-top <html-code> Include top text for each page
-bottom <html-code> Include bottom text for each page
-link <url> Create links to javadoc output at <url>
-linkoffline <url> <url2> Link to docs at <url> using package list at
<url2>
-excludedocfilessubdir <name1>:.. Exclude any doc-files subdirectories with
given name.
-group <name> <p1>:<p2>.. Group specified packages together in overview
page
-nocomment Supress description and tags, generate only
declarations.
-nodeprecated Do not include @deprecated information
-noqualifier <name1>:<name2>:... Exclude the list of qualifiers from the
output.
-nosince Do not include @since information
-notimestamp Do not include hidden time stamp
-nodeprecatedlist Do not generate deprecated list
-notree Do not generate class hierarchy
-noindex Do not generate index
-nohelp Do not generate help link
-nonavbar Do not generate navigation bar
-serialwarn Generate warning about @serial tag
-tag <name>:<locations>:<header> Specify single argument custom tags
-taglet The fully qualified name of Taglet to register
-tagletpath The path to Taglets
-Xdocrootparent <url> Replaces all appearances of @docRoot followed
by /.. in doc comments with <url>
-charset <charset> Charset for cross-platform viewing of
generated documentation.
-helpfile <file> Include file that help link links to
-linksource Generate source in HTML
-sourcetab <tab length> Specify the number of spaces each tab takes
up in the source
-keywords Include HTML meta tags with package, class
and member info
-stylesheetfile <path> File to change style of the generated
documentation
-docencoding <name> Output encoding name
1 error
[INFO] ------------------------------------------------------------------------
[INFO] Reactor Summary:
[INFO]
[INFO] Lens Checkstyle Rules .............................. SUCCESS [ 5.881 s]
[INFO] Lens ............................................... FAILURE [02:30 min]
[INFO] Lens API ........................................... SKIPPED
[INFO] Lens API for server and extensions ................. SKIPPED
[INFO] Lens Cube .......................................... SKIPPED
[INFO] Lens DB storage .................................... SKIPPED
[INFO] Lens Query Library ................................. SKIPPED
[INFO] Lens Hive Driver ................................... SKIPPED
[INFO] Lens Driver for JDBC ............................... SKIPPED
[INFO] Lens Server ........................................ SKIPPED
[INFO] Lens client ........................................ SKIPPED
[INFO] Lens CLI ........................................... SKIPPED
[INFO] Lens Examples ...................................... SKIPPED
[INFO] Lens Distribution .................................. SKIPPED
[INFO] Lens ML Lib ........................................ SKIPPED
[INFO] Lens ML Ext Distribution ........................... SKIPPED
[INFO] Lens Regression .................................... SKIPPED
[INFO] ------------------------------------------------------------------------
[INFO] BUILD FAILURE
[INFO] ------------------------------------------------------------------------
[INFO] Total time: 02:37 min
[INFO] Finished at: 2015-06-16T16:33:23+05:30
[INFO] Final Memory: 44M/241M
[INFO] ------------------------------------------------------------------------
[ERROR] Failed to execute goal
org.apache.maven.plugins:maven-site-plugin:3.4:site (default-site) on project
apache-lens: Error generating maven-javadoc-plugin:2.9.1:aggregate:
[ERROR] Exit code: 1 - javadoc: error - invalid flag: -Xdoclint:none
[ERROR]
[ERROR] Command line was:
/Library/Java/JavaVirtualMachines/jdk1.7.0_79.jdk/Contents/Home/bin/javadoc
@options @packages
{noformat}
> Errors while generating javadoc on java8
> ----------------------------------------
>
> Key: LENS-493
> URL: https://issues.apache.org/jira/browse/LENS-493
> Project: Apache Lens
> Issue Type: Sub-task
> Components: build
> Reporter: Raju Bairishetti
> Assignee: Raju Bairishetti
> Fix For: 2.2
>
> Attachments: LENS-493.patch
>
>
> With JDK 8, we are unable to get Javadoc unless your tool meets the standards
> of doclint. Some of its rules are:
> {noformat}
> 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
> {noformat}
> We don't get any output if it breaks any of the above rule. It throws errors.
> We can turn off doclint by configuring the following propery for javadoc
> plugin
> *<additionalparam>-Xdoclint:none</additionalparam>*
--
This message was sent by Atlassian JIRA
(v6.3.4#6332)
