cxf-issues mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From "Daniel Kulp (JIRA)" <j...@apache.org>
Subject [jira] [Resolved] (CXF-5375) xjc-javadoc plugin for generating more javadocs from xsd:documentation
Date Tue, 19 Nov 2013 15:53:21 GMT

     [ https://issues.apache.org/jira/browse/CXF-5375?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel
]

Daniel Kulp resolved CXF-5375.
------------------------------

       Resolution: Fixed
    Fix Version/s: 3.0.0
         Assignee: Daniel Kulp

> xjc-javadoc plugin for generating more javadocs from xsd:documentation
> ----------------------------------------------------------------------
>
>                 Key: CXF-5375
>                 URL: https://issues.apache.org/jira/browse/CXF-5375
>             Project: CXF
>          Issue Type: Improvement
>          Components: Tooling
>            Reporter: David Pytel
>            Assignee: Daniel Kulp
>             Fix For: 3.0.0
>
>         Attachments: HTTPClientPolicy.java
>
>
> Answering Stackoverflow question: 
> http://stackoverflow.com/questions/19444064/cxf-wsdl2java-not-generating-javadoc-for-members
> I noticed that there is a lack of support for xsd:documentation in XJC. Generated code
representing some elements (like properties or attributes) does not have proper javadocs based
on xsd:documentation. There is JAXB bug raised:
> https://java.net/jira/browse/JAXB-172
> but it is not resolved for over 7 years. There is also link to CXF bug CXF-2486 and there
is Dan Kulp's comment:
> {quote}
> If you'd like to donate the code to CXF, we could certainly use it. CXF
> already has a couple plugins to workaround XJC issues. 
> {quote}
> However I didn't see such a plugin in CXF project, I didn't found it on the internet.
So I decided to try to develop one. The result is available at my github account:
> https://github.com/destin/xjc-javadoc-plugin
> The plugin solves CXF-2486 problem (output java file is available as attachment) and
makes generated files better documented. I am willing to contribute this plugin to CXF XJC
utils (http://cxf.apache.org/xjc-utils.html).
> I tested it on several larger XSD files, also there are few almost end-to-end automated
tests.
> Please let me know whether you are interested in taking over this plugin and what modifications
do you expect.



--
This message was sent by Atlassian JIRA
(v6.1#6144)

Mime
View raw message