[ 
https://issues.apache.org/jira/browse/CXF-5479?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=13956371#comment-13956371
 ] 

Sergey Beryozkin commented on CXF-5479:
---------------------------------------

Hi Freeman, thanks for the patch. I think it is looking good and neat.

What I'd like to address though is how JavaDocs can be properly translated to 
WADL doc. 

org.apache.cxf.jaxrs.model.wadl.JavaDocProvider works but its implementation is 
far from being perfect as it does the text based primitive analysis of the 
generated HTML.
So we'd need to run the java docs target before this plugin for a start and 
we'd also need to configure it to point to the generated JavaDocs archive. 

Can you please experiment a bit more and see how a proper JacaDocs generator 
operating with the JavaDocs model API can be plugged in ? I think/hope it would 
also be possible to wrap as DocumentationProvider but I'd like to get it done 
first before we do commit this code in order to validate that we can have 
JavaDocs generated. I think we may have already the JavaDocs integration in 
some of WS tools

Cheers, Sergey

> Create a Maven plugin for generating WADL at build time
> -------------------------------------------------------
>
>                 Key: CXF-5479
>                 URL: https://issues.apache.org/jira/browse/CXF-5479
>             Project: CXF
>          Issue Type: New Feature
>          Components: JAX-RS
>            Reporter: Sergey Beryozkin
>            Assignee: Freeman Fang
>         Attachments: CXF-5479.patch
>
>




--
This message was sent by Atlassian JIRA
(v6.2#6252)

Reply via email to