Uploaded image for project: 'Karaf'
  1. Karaf
  2. KARAF-4030

Doclint for Javadoc fails on JDK 8

    Details

    • Type: Bug
    • Status: Resolved
    • Priority: Major
    • Resolution: Fixed
    • Affects Version/s: None
    • Fix Version/s: 4.0.2
    • Component/s: None
    • Labels:
      None

      Description

      We can't currently generate javadoc using JDK 8. Getting error similar to:

      [ERROR] Failed to execute goal org.apache.maven.plugins:maven-javadoc-plugin:2.9.1:jar (attach-javadocs) on project org.apache.karaf.util: MavenReportException: Error while creating archive:
      [ERROR] Exit code: 1 - /x1/git/karaf/util/src/main/java/org/apache/karaf/util/StringEscapeUtils.java:142: error: unexpected end tag: </p>
      [ERROR] * </p>
      [ERROR] ^
      [ERROR] /x1/git/karaf/util/src/main/java/org/apache/karaf/util/process/PumpStreamHandler.java:76: warning: no @param for in
      [ERROR] public void setChildOutputStream(final InputStream in) {
      [ERROR] ^
      [ERROR] /x1/git/karaf/util/src/main/java/org/apache/karaf/util/process/PumpStreamHandler.java:85: warning: no @param for in
      [ERROR] public void setChildErrorStream(final InputStream in) {
      [ERROR] ^
      [ERROR] /x1/git/karaf/util/src/main/java/org/apache/karaf/util/process/PumpStreamHandler.java:96: warning: no @param for out
      [ERROR] public void setChildInputStream(final OutputStream out) {
      [ERROR] ^
      [ERROR] /x1/git/karaf/util/src/main/java/org/apache/karaf/util/process/PumpStreamHandler.java:195: warning: no @param for in
      [ERROR] protected void createChildOutputPump(final InputStream in, final OutputStream out) {
      [ERROR] ^
      [ERROR] /x1/git/karaf/util/src/main/java/org/apache/karaf/util/process/PumpStreamHandler.java:195: warning: no @param for out
      [ERROR] protected void createChildOutputPump(final InputStream in, final OutputStream out) {
      [ERROR] ^
      [ERROR] /x1/git/karaf/util/src/main/java/org/apache/karaf/util/process/PumpStreamHandler.java:205: warning: no @param for in
      [ERROR] protected void createChildErrorPump(final InputStream in, final OutputStream out) {
      [ERROR] ^
      [ERROR] /x1/git/karaf/util/src/main/java/org/apache/karaf/util/process/PumpStreamHandler.java:205: warning: no @param for out
      [ERROR] protected void createChildErrorPump(final InputStream in, final OutputStream out) {
      [ERROR] ^
      [ERROR] /x1/git/karaf/util/src/main/java/org/apache/karaf/util/process/PumpStreamHandler.java:215: warning: no @param for in
      [ERROR] protected StreamPumper createPump(final InputStream in, final OutputStream out) {
      [ERROR] ^
      [ERROR] /x1/git/karaf/util/src/main/java/org/apache/karaf/util/process/PumpStreamHandler.java:215: warning: no @param for out
      [ERROR] protected StreamPumper createPump(final InputStream in, final OutputStream out) {
      [ERROR] ^
      [ERROR] /x1/git/karaf/util/src/main/java/org/apache/karaf/util/process/PumpStreamHandler.java:215: warning: no @return
      [ERROR] protected StreamPumper createPump(final InputStream in, final OutputStream out) {
      [ERROR] ^
      [ERROR] /x1/git/karaf/util/src/main/java/org/apache/karaf/util/process/PumpStreamHandler.java:243: warning: no @param for in
      [ERROR] protected StreamPumper createInputPump(final InputStream in, final OutputStream out, final boolean closeWhenExhausted) {
      [ERROR] ^
      [ERROR] /x1/git/karaf/util/src/main/java/org/apache/karaf/util/process/PumpStreamHandler.java:243: warning: no @param for out
      [ERROR] protected StreamPumper createInputPump(final InputStream in, final OutputStream out, final boolean closeWhenExhausted) {
      [ERROR] ^
      [ERROR] /x1/git/karaf/util/src/main/java/org/apache/karaf/util/process/PumpStreamHandler.java:243: warning: no @param for closeWhenExhausted
      [ERROR] protected StreamPumper createInputPump(final InputStream in, final OutputStream out, final boolean closeWhenExhausted) {
      [ERROR] ^
      [ERROR] /x1/git/karaf/util/src/main/java/org/apache/karaf/util/process/PumpStreamHandler.java:243: warning: no @return
      [ERROR] protected StreamPumper createInputPump(final InputStream in, final OutputStream out, final boolean closeWhenExhausted) {
      [ERROR] ^
      [ERROR] /x1/git/karaf/util/src/main/java/org/apache/karaf/util/process/StreamPumper.java:191: warning: no @throws for java.lang.InterruptedException
      [ERROR] public synchronized void waitFor() throws InterruptedException {
      [ERROR] ^
      [ERROR] /x1/git/karaf/util/src/main/java/org/apache/karaf/util/maven/Parser.java:157: warning: no description for @throws
      [ERROR] * @throws MalformedURLException
      [ERROR] ^
      [ERROR] /x1/git/karaf/util/src/main/java/org/apache/karaf/util/maven/Parser.java:25: error: self-closing element not allowed
      [ERROR] * Parser for mvn: protocol.<br/>
      [ERROR] ^
      [ERROR] /x1/git/karaf/util/src/main/java/org/apache/karaf/util/config/PropertiesLoader.java:60: warning: no @param for file
      [ERROR] public static Properties loadConfigProperties(File file) throws Exception {
      [ERROR] ^
      [ERROR] /x1/git/karaf/util/src/main/java/org/apache/karaf/util/config/PropertiesLoader.java:99: error: @param name not found
      [ERROR] * @param karafBase the karaf base folder
      [ERROR] ^
      [ERROR] /x1/git/karaf/util/src/main/java/org/apache/karaf/util/config/PropertiesLoader.java:100: warning: no description for @throws
      [ERROR] * @throws IOException
      [ERROR] ^
      [ERROR] /x1/git/karaf/util/src/main/java/org/apache/karaf/util/config/PropertiesLoader.java:102: warning: no @param for file
      [ERROR] public static void loadSystemProperties(File file) throws IOException {
      [ERROR] ^
      [ERROR] /x1/git/karaf/util/src/main/java/org/apache/karaf/util/tracker/BaseActivator.java:134: warning: no @param for pid
      [ERROR] protected void manage(String pid) {
      [ERROR] ^
      [ERROR] /x1/git/karaf/util/src/main/java/org/apache/karaf/util/tracker/BaseActivator.java:152: warning: no @param for key
      [ERROR] protected int getInt(String key, int def) {
      [ERROR] ^
      [ERROR] /x1/git/karaf/util/src/main/java/org/apache/karaf/util/tracker/BaseActivator.java:152: warning: no @param for def
      [ERROR] protected int getInt(String key, int def) {
      [ERROR] ^
      [ERROR] /x1/git/karaf/util/src/main/java/org/apache/karaf/util/tracker/BaseActivator.java:152: warning: no @return
      [ERROR] protected int getInt(String key, int def) {
      [ERROR] ^
      [ERROR] /x1/git/karaf/util/src/main/java/org/apache/karaf/util/tracker/BaseActivator.java:167: warning: no @param for key
      [ERROR] protected boolean getBoolean(String key, boolean def) {
      [ERROR] ^
      [ERROR] /x1/git/karaf/util/src/main/java/org/apache/karaf/util/tracker/BaseActivator.java:167: warning: no @param for def
      [ERROR] protected boolean getBoolean(String key, boolean def) {
      [ERROR] ^
      [ERROR] /x1/git/karaf/util/src/main/java/org/apache/karaf/util/tracker/BaseActivator.java:167: warning: no @return
      [ERROR] protected boolean getBoolean(String key, boolean def) {
      [ERROR] ^
      [ERROR] /x1/git/karaf/util/src/main/java/org/apache/karaf/util/tracker/BaseActivator.java:182: warning: no @param for key
      [ERROR] protected long getLong(String key, long def) {
      [ERROR] ^
      [ERROR] /x1/git/karaf/util/src/main/java/org/apache/karaf/util/tracker/BaseActivator.java:182: warning: no @param for def
      [ERROR] protected long getLong(String key, long def) {
      [ERROR] ^
      [ERROR] /x1/git/karaf/util/src/main/java/org/apache/karaf/util/tracker/BaseActivator.java:182: warning: no @return
      [ERROR] protected long getLong(String key, long def) {
      [ERROR] ^
      [ERROR] /x1/git/karaf/util/src/main/java/org/apache/karaf/util/tracker/BaseActivator.java:197: warning: no @param for key
      [ERROR] protected String getString(String key, String def) {
      [ERROR] ^
      [ERROR] /x1/git/karaf/util/src/main/java/org/apache/karaf/util/tracker/BaseActivator.java:197: warning: no @param for def
      [ERROR] protected String getString(String key, String def) {
      [ERROR] ^
      [ERROR] /x1/git/karaf/util/src/main/java/org/apache/karaf/util/tracker/BaseActivator.java:197: warning: no @return
      [ERROR] protected String getString(String key, String def) {
      [ERROR] ^
      [ERROR] /x1/git/karaf/util/src/main/java/org/apache/karaf/util/tracker/BaseActivator.java:243: warning: no @param for clazz
      [ERROR] protected void trackService(Class<?> clazz) throws InvalidSyntaxException {
      [ERROR] ^
      [ERROR] /x1/git/karaf/util/src/main/java/org/apache/karaf/util/tracker/BaseActivator.java:243: warning: no @throws for org.osgi.framework.InvalidSyntaxException
      [ERROR] protected void trackService(Class<?> clazz) throws InvalidSyntaxException {
      [ERROR] ^
      [ERROR] /x1/git/karaf/util/src/main/java/org/apache/karaf/util/tracker/BaseActivator.java:254: warning: no @param for clazz
      [ERROR] protected void trackService(Class<?> clazz, String filter) throws InvalidSyntaxException {
      [ERROR] ^
      [ERROR] /x1/git/karaf/util/src/main/java/org/apache/karaf/util/tracker/BaseActivator.java:254: warning: no @param for filter
      [ERROR] protected void trackService(Class<?> clazz, String filter) throws InvalidSyntaxException {
      [ERROR] ^
      [ERROR] /x1/git/karaf/util/src/main/java/org/apache/karaf/util/tracker/BaseActivator.java:254: warning: no @throws for org.osgi.framework.InvalidSyntaxException
      [ERROR] protected void trackService(Class<?> clazz, String filter) throws InvalidSyntaxException {
      [ERROR] ^
      [ERROR] /x1/git/karaf/util/src/main/java/org/apache/karaf/util/tracker/BaseActivator.java:276: warning: no @param for <T>
      [ERROR] protected <T> T getTrackedService(Class<T> clazz) {
      [ERROR] ^
      [ERROR] /x1/git/karaf/util/src/main/java/org/apache/karaf/util/tracker/BaseActivator.java:276: warning: no @param for clazz
      [ERROR] protected <T> T getTrackedService(Class<T> clazz) {
      [ERROR] ^
      [ERROR] /x1/git/karaf/util/src/main/java/org/apache/karaf/util/tracker/BaseActivator.java:276: warning: no @return
      [ERROR] protected <T> T getTrackedService(Class<T> clazz) {
      [ERROR] ^
      [ERROR] /x1/git/karaf/util/src/main/java/org/apache/karaf/util/tracker/BaseActivator.java:287: warning: no @param for mbean
      [ERROR] protected void registerMBean(Object mbean, String type) {
      [ERROR] ^
      [ERROR] /x1/git/karaf/util/src/main/java/org/apache/karaf/util/tracker/BaseActivator.java:287: warning: no @param for type
      [ERROR] protected void registerMBean(Object mbean, String type) {
      [ERROR] ^
      [ERROR] /x1/git/karaf/util/src/main/java/org/apache/karaf/util/tracker/BaseActivator.java:296: warning: no @param for <T>
      [ERROR] protected <T> void register(Class<T> clazz, T service) {
      [ERROR] ^
      [ERROR] /x1/git/karaf/util/src/main/java/org/apache/karaf/util/tracker/BaseActivator.java:296: warning: no @param for clazz
      [ERROR] protected <T> void register(Class<T> clazz, T service) {
      [ERROR] ^
      [ERROR] /x1/git/karaf/util/src/main/java/org/apache/karaf/util/tracker/BaseActivator.java:296: warning: no @param for service
      [ERROR] protected <T> void register(Class<T> clazz, T service) {
      [ERROR] ^
      [ERROR] /x1/git/karaf/util/src/main/java/org/apache/karaf/util/tracker/BaseActivator.java:303: warning: no @param for <T>
      [ERROR] protected <T> void register(Class<T> clazz, T service, Dictionary<String, ?> props) {
      [ERROR] ^
      [ERROR] /x1/git/karaf/util/src/main/java/org/apache/karaf/util/tracker/BaseActivator.java:303: warning: no @param for clazz
      [ERROR] protected <T> void register(Class<T> clazz, T service, Dictionary<String, ?> props) {
      [ERROR] ^
      [ERROR] /x1/git/karaf/util/src/main/java/org/apache/karaf/util/tracker/BaseActivator.java:303: warning: no @param for service
      [ERROR] protected <T> void register(Class<T> clazz, T service, Dictionary<String, ?> props) {
      [ERROR] ^
      [ERROR] /x1/git/karaf/util/src/main/java/org/apache/karaf/util/tracker/BaseActivator.java:303: warning: no @param for props
      [ERROR] protected <T> void register(Class<T> clazz, T service, Dictionary<String, ?> props) {
      [ERROR] ^
      [ERROR] /x1/git/karaf/util/src/main/java/org/apache/karaf/util/tracker/BaseActivator.java:310: warning: no @param for clazz
      [ERROR] protected void register(Class[] clazz, Object service) {
      [ERROR] ^
      [ERROR] /x1/git/karaf/util/src/main/java/org/apache/karaf/util/tracker/BaseActivator.java:310: warning: no @param for service
      [ERROR] protected void register(Class[] clazz, Object service) {
      [ERROR] ^
      [ERROR] /x1/git/karaf/util/src/main/java/org/apache/karaf/util/tracker/BaseActivator.java:317: warning: no @param for clazz
      [ERROR] protected void register(Class[] clazz, Object service, Dictionary<String, ?> props) {
      [ERROR] ^
      [ERROR] /x1/git/karaf/util/src/main/java/org/apache/karaf/util/tracker/BaseActivator.java:317: warning: no @param for service
      [ERROR] protected void register(Class[] clazz, Object service, Dictionary<String, ?> props) {
      [ERROR] ^
      [ERROR] /x1/git/karaf/util/src/main/java/org/apache/karaf/util/tracker/BaseActivator.java:317: warning: no @param for props
      [ERROR] protected void register(Class[] clazz, Object service, Dictionary<String, ?> props) {
      [ERROR] ^
      [ERROR] /x1/git/karaf/util/src/main/java/org/apache/karaf/util/collections/CopyOnWriteArrayIdentityList.java:1155: warning: no @throws for java.lang.ClassNotFoundException
      [ERROR] private void readObject(ObjectInputStream ois) throws IOException,
      [ERROR] ^
      [ERROR]
      [ERROR] Command line was: /opt/jdk1.8.0_40/jre/../bin/javadoc @options @packages
      [ERROR]
      [ERROR] Refer to the generated Javadoc files in '/x1/git/karaf/util/target/apidocs' 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 :org.apache.karaf.util

        Attachments

          Activity

            People

            • Assignee:
              janstey Jonathan Anstey
              Reporter:
              janstey Jonathan Anstey
            • Votes:
              0 Vote for this issue
              Watchers:
              1 Start watching this issue

              Dates

              • Created:
                Updated:
                Resolved: