You are viewing a plain text version of this content. The canonical link for it is here.
Posted to users@cxf.apache.org by jm...@logicsector.com on 2009/01/29 02:03:59 UTC
Any way to automatically generate documentation?
Hi all,
I have a SOAP service I implemented with CXF. The service's underlying
Java classes are documented via JavaDoc comments.
My question is... Is there any way to generate nice SOAP interface
documentation which would pull the comments directly from the JavaDoc?
The documentation would then be given to clients who want to use my SOAP
api.
(I know that XMLspy will generate basic docs directly from the WSDL file,
but I'm hoping there's an easier, more direct, and FREE way to do this
using CXF or related tools.)
Many thanks!
Re: Any way to automatically generate documentation?
Posted by conficio <Ka...@Conficio.com>.
jmorgan-2 wrote:
>
> Hi all,
>
> I have a SOAP service I implemented with CXF. The service's underlying
> Java classes are documented via JavaDoc comments.
>
> My question is... Is there any way to generate nice SOAP interface
> documentation which would pull the comments directly from the JavaDoc?
> The documentation would then be given to clients who want to use my SOAP
> api.
>
> (I know that XMLspy will generate basic docs directly from the WSDL file,
> but I'm hoping there's an easier, more direct, and FREE way to do this
> using CXF or related tools.)
>
> Many thanks!
>
>
>
I'd like to second this. I'd love to know such a tool as well.
Thanks
--
View this message in context: http://www.nabble.com/Any-way-to-automatically-generate-documentation--tp21718930p21812594.html
Sent from the cxf-user mailing list archive at Nabble.com.
Re: Any way to automatically generate documentation?
Posted by Daniel Kulp <dk...@apache.org>.
On Wed January 28 2009 8:03:59 pm jmorgan@logicsector.com wrote:
> Hi all,
>
> I have a SOAP service I implemented with CXF. The service's underlying
> Java classes are documented via JavaDoc comments.
Not yet. :-(
There is a JIRA item to add a "@WSDLDocumentation(".....")" annotation or
similar, just hasn't been done yet.
Dan
>
> My question is... Is there any way to generate nice SOAP interface
> documentation which would pull the comments directly from the JavaDoc?
> The documentation would then be given to clients who want to use my SOAP
> api.
>
> (I know that XMLspy will generate basic docs directly from the WSDL file,
> but I'm hoping there's an easier, more direct, and FREE way to do this
> using CXF or related tools.)
>
> Many thanks!
--
Daniel Kulp
dkulp@apache.org
http://www.dankulp.com/blog