You are viewing a plain text version of this content. The canonical link for it is here.
Posted to users@camel.apache.org by Frizz <fr...@googlemail.com> on 2015/09/23 07:34:49 UTC

How to generate Javadoc?

Hi there,

I just downloaded Camel 2.15.3 source and tried to generate the javadocs
for the project by running "mvn javadoc:javadoc" in the project root
directory - but it failed:

[ERROR] Failed to execute goal
org.apache.maven.plugins:maven-javadoc-plugin:2.9.1:javadoc (default-cli)
on project spi-annotations: An error has occurred in JavaDocs report genera
tion:
[ERROR] Exit code: 1 -
D:\Projects\Apache\apache-camel-2.15.3\tooling\spi-annotations\src\main\java\org\apache\camel\spi\Metadata.java:27:
error: self-closing element not allowed
[ERROR] * <p/>
[ERROR] ^
[ERROR]
D:\Projects\Apache\apache-camel-2.15.3\tooling\spi-annotations\src\main\java\org\apache\camel\spi\Metadata.java:45:
warning: no @return
[ERROR] String defaultValue() default "";
[ERROR] ^
[ERROR]
D:\Projects\Apache\apache-camel-2.15.3\tooling\spi-annotations\src\main\java\org\apache\camel\spi\Metadata.java:37:
error: self-closing element not allowed
[ERROR] * <p/>
[ERROR] ^
[ERROR]
D:\Projects\Apache\apache-camel-2.15.3\tooling\spi-annotations\src\main\java\org\apache\camel\spi\Metadata.java:40:
warning: no @return
[ERROR] String label() default "";
[ERROR] ^
...

How do I fix this?

cheers,
F.

Re: How to generate Javadoc?

Posted by Joakim Bjørnstad <jo...@gmail.com>.
Hello,

Do you compile on JDK8? If so, try to turn off Javadoc linting.

Please check this:
http://stackoverflow.com/questions/15886209/maven-is-not-working-in-java-8-when-javadoc-tags-are-incomplete
And this:
http://blog.joda.org/2014/02/turning-off-doclint-in-jdk-8-javadoc.html

On Wed, Sep 23, 2015 at 7:34 AM, Frizz <fr...@googlemail.com> wrote:

> Hi there,
>
> I just downloaded Camel 2.15.3 source and tried to generate the javadocs
> for the project by running "mvn javadoc:javadoc" in the project root
> directory - but it failed:
>
> [ERROR] Failed to execute goal
> org.apache.maven.plugins:maven-javadoc-plugin:2.9.1:javadoc (default-cli)
> on project spi-annotations: An error has occurred in JavaDocs report genera
> tion:
> [ERROR] Exit code: 1 -
>
> D:\Projects\Apache\apache-camel-2.15.3\tooling\spi-annotations\src\main\java\org\apache\camel\spi\Metadata.java:27:
> error: self-closing element not allowed
> [ERROR] * <p/>
> [ERROR] ^
> [ERROR]
>
> D:\Projects\Apache\apache-camel-2.15.3\tooling\spi-annotations\src\main\java\org\apache\camel\spi\Metadata.java:45:
> warning: no @return
> [ERROR] String defaultValue() default "";
> [ERROR] ^
> [ERROR]
>
> D:\Projects\Apache\apache-camel-2.15.3\tooling\spi-annotations\src\main\java\org\apache\camel\spi\Metadata.java:37:
> error: self-closing element not allowed
> [ERROR] * <p/>
> [ERROR] ^
> [ERROR]
>
> D:\Projects\Apache\apache-camel-2.15.3\tooling\spi-annotations\src\main\java\org\apache\camel\spi\Metadata.java:40:
> warning: no @return
> [ERROR] String label() default "";
> [ERROR] ^
> ...
>
> How do I fix this?
>
> cheers,
> F.
>



-- 
Med vennlig hilsen
Joakim Bjørnstad