From: Farrukh Najmi <farrukh_at_wellfleetsoftware.com>
Date: Thu, 18 Dec 2008 14:14:10 -0500

Dear colleagues,

I need to be able to generate javadoc for my JAXB generated bindings. When I use the maven-javadoc-plugin  with default configuration and the goal javadoc:javadoc I do not get the javadoc for generated classes. Is this a known bug in mavn-javadoc-plugin? If so, what is the workaround short of copying generated files to source tree?

Also, I notice that the JAXB compilation does not produce a package description HTML file from the /xsd:schema/xsd:annotation/xsd:documentation element if present. This would be a very nice feature in the JAXB RI and something the spec should consider as well. The motivations is that javadoc from JAXB generated bindings would be complete with package description available for each package.

So we would generate a nicely descriptive javadoc page like this:

Packages
org.freebxml.omar.jaxb.bindings.lcm._4_0	The schema for the lifecycle manager protocols of ebXML RegRep
org.freebxml.omar.jaxb.bindings.query._4_0	The schema for the query manager protocol of ebXML RegRep
org.freebxml.omar.jaxb.bindings.rim._4_0	The schema for the ebXML RegRep Registry Information Model
org.freebxml.omar.jaxb.bindings.rs._4_0	The base schema common to most protocols of ebXML RegRep
org.freebxml.omar.jaxb.bindings.spi._4_0	The schema for the service provider interface protocols for ebXML RegRep

 
Instead of a less useful one like this:

Packages
org.freebxml.omar.jaxb.bindings.lcm._4_0
org.freebxml.omar.jaxb.bindings.query._4_0
org.freebxml.omar.jaxb.bindings.rim._4_0
org.freebxml.omar.jaxb.bindings.rs._4_0
org.freebxml.omar.jaxb.bindings.spi._4_0

Should I file an RFE. If so how can I make sure the RFE is on RI and spec both? Thanks.

-- 
Regards,
Farrukh Najmi

Web: http://www.wellfleetsoftware.com