javadoc for servicebuilder generate

[Jack Bakker, modifié il y a 9 années.]

after generating with service builder, how might I get javadoc of service utils and model ?

[David H Nebinger, modifié il y a 9 années.]

How are you doing the build?

Note the javadoc is pretty much naked, no real helpful comments whatsoever, nor will it include any details from parent classes...

[Jack Bakker, modifié il y a 9 années.]

David H Nebinger:

How are you doing the build?

each of ant (via Eclipse) and maven (via IntelliJ IDEA)

David H Nebinger:

Note the javadoc is pretty much naked, no real helpful comments whatsoever, nor will it include any details from parent classes...

yeah, my hope is to make available the javadoc in WEB-INF of the service portlet, so that developers can conveniently see the latest after they deploy (in particular service util method signatures)

[David H Nebinger, modifié il y a 9 années.]

The sdk has a "javadoc" target, there's also a "javadoc-jar" to build a jar of the javadoc.

Javadocs generation is a completely separate recipe AFAIK, one that you can add using a standard recipe found on the net.

Personally I've never found naked javadocs to be any help at all. Code completion within the IDE is usually of more value than them.

[lucas theisen, modifié il y a 9 années.]

Maven javadoc:jar fails if the javadoc is not properly generated... Even if it is naked. So, while it may not be useful for information, it would still be useful to avoid build failures.