Re: WADL documentation via Javadoc?

2013-10-23 Thread Francesco Chicchiriccò
On 22/10/2013 17:05, Sergey Beryozkin wrote: Hi Francesco On 22/10/13 14:58, Francesco Chicchiriccò wrote: On 21/10/2013 11:31, Sergey Beryozkin wrote: Hi Francesco, On 21/10/13 07:58, Francesco Chicchiriccò wrote: On 18/10/2013 19:06, Sergey Beryozkin wrote: Hi All, I wonder if we can try

Re: WADL documentation via Javadoc?

2013-10-23 Thread Sergey Beryozkin
Hi, On 23/10/13 12:40, Francesco Chicchiriccò wrote: On 22/10/2013 17:05, Sergey Beryozkin wrote: Hi Francesco On 22/10/13 14:58, Francesco Chicchiriccò wrote: On 21/10/2013 11:31, Sergey Beryozkin wrote: Hi Francesco, On 21/10/13 07:58, Francesco Chicchiriccò wrote: On 18/10/2013 19:06,

Re: WADL documentation via Javadoc?

2013-10-22 Thread Francesco Chicchiriccò
On 21/10/2013 11:31, Sergey Beryozkin wrote: Hi Francesco, On 21/10/13 07:58, Francesco Chicchiriccò wrote: On 18/10/2013 19:06, Sergey Beryozkin wrote: Hi All, I wonder if we can try and add a property to WadlGenerator, such as checkJavaDocs or may be javaDocsClassPath which will point to a

Re: WADL documentation via Javadoc?

2013-10-22 Thread Sergey Beryozkin
Hi Francesco On 22/10/13 14:58, Francesco Chicchiriccò wrote: On 21/10/2013 11:31, Sergey Beryozkin wrote: Hi Francesco, On 21/10/13 07:58, Francesco Chicchiriccò wrote: On 18/10/2013 19:06, Sergey Beryozkin wrote: Hi All, I wonder if we can try and add a property to WadlGenerator, such as

Re: WADL documentation via Javadoc?

2013-10-21 Thread Francesco Chicchiriccò
On 18/10/2013 19:06, Sergey Beryozkin wrote: Hi All, I wonder if we can try and add a property to WadlGenerator, such as checkJavaDocs or may be javaDocsClassPath which will point to a generated java docs jar, then suppose it processes a root class like mypackage.Root, then it will look for

Re: WADL documentation via Javadoc?

2013-10-21 Thread Francesco Chicchiriccò
On 18/10/2013 17:08, Winnebeck, Jason wrote: -Original Message- From: Francesco Chicchiriccò [mailto:ilgro...@apache.org] Sent: Friday, October 18, 2013 10:21 AM I could not get any XML type information about method parameters; WADL fragment was something like param name=executionId

Re: WADL documentation via Javadoc?

2013-10-21 Thread Sergey Beryozkin
Hi Francesco, On 21/10/13 07:58, Francesco Chicchiriccò wrote: On 18/10/2013 19:06, Sergey Beryozkin wrote: Hi All, I wonder if we can try and add a property to WadlGenerator, such as checkJavaDocs or may be javaDocsClassPath which will point to a generated java docs jar, then suppose it

RE: WADL documentation via Javadoc?

2013-10-21 Thread Winnebeck, Jason
-Original Message- From: Francesco Chicchiriccò [mailto:ilgro...@apache.org] Sent: Monday, October 21, 2013 3:08 AM Oh yes, I've tried Swagger (via their JAX-RS / CXF sample [1]) and I really like its output; however, the final WAR from such very basic sample is about 40 MB, mainly

Re: WADL documentation via Javadoc?

2013-10-18 Thread Francesco Chicchiriccò
On 15/10/2013 17:32, Daniel Kulp wrote: Interesting…. We haven't really looked at anything javadoc related as that information isn't available at runtime. It's only available at build time and thus we'd need special tools and such to parse the javadoc at build time, output a file or

Re: WADL documentation via Javadoc?

2013-10-18 Thread Francesco Chicchiriccò
On 18/10/2013 10:59, Francesco Chicchiriccò wrote: On 15/10/2013 17:32, Daniel Kulp wrote: Interesting…. We haven't really looked at anything javadoc related as that information isn't available at runtime. It's only available at build time and thus we'd need special tools and such to parse

RE: WADL documentation via Javadoc?

2013-10-18 Thread Winnebeck, Jason
-Original Message- From: Francesco Chicchiriccò [mailto:ilgro...@apache.org] Sent: Friday, October 18, 2013 5:00 AM I've been trying Enunciate in these days, for documentation only [3], via its maven plugin. While generating doc elements from Javadocs was working fine (I guess

Re: WADL documentation via Javadoc?

2013-10-18 Thread Francesco Chicchiriccò
On 18/10/2013 16:04, Winnebeck, Jason wrote: -Original Message- From: Francesco Chicchiriccò [mailto:ilgro...@apache.org] Sent: Friday, October 18, 2013 5:00 AM I've been trying Enunciate in these days, for documentation only [3], via its maven plugin. While generating doc elements from

RE: WADL documentation via Javadoc?

2013-10-18 Thread Winnebeck, Jason
-Original Message- From: Francesco Chicchiriccò [mailto:ilgro...@apache.org] Sent: Friday, October 18, 2013 10:21 AM I could not get any XML type information about method parameters; WADL fragment was something like param name=executionId style=template/ while I would have

Re: WADL documentation via Javadoc?

2013-10-18 Thread Sergey Beryozkin
Hi On 18/10/13 15:04, Winnebeck, Jason wrote: -Original Message- From: Francesco Chicchiriccò [mailto:ilgro...@apache.org] Sent: Friday, October 18, 2013 5:00 AM I've been trying Enunciate in these days, for documentation only [3], via its maven plugin. While generating doc elements

Re: WADL documentation via Javadoc?

2013-10-18 Thread Sergey Beryozkin
Hi All, I wonder if we can try and add a property to WadlGenerator, such as checkJavaDocs or may be javaDocsClassPath which will point to a generated java docs jar, then suppose it processes a root class like mypackage.Root, then it will look for /mypackage/Root.html Java Doc resource, load

RE: WADL documentation via Javadoc?

2013-10-15 Thread Winnebeck, Jason
I am using a tool called Enunciate to do this: http://enunciate.codehaus.org/index.html It's confusing at first because Enunciate generates interface definition documents (like WADL) but also wants to publish your code, it wants to replace the whole J2EE build environment. But you can use it to

Re: WADL documentation via Javadoc?

2013-10-15 Thread Sergey Beryozkin
Hi On 15/10/13 15:13, Winnebeck, Jason wrote: I am using a tool called Enunciate to do this: http://enunciate.codehaus.org/index.html It's confusing at first because Enunciate generates interface definition documents (like WADL) but also wants to publish your code, it wants to replace the

Re: WADL documentation via Javadoc?

2013-10-15 Thread Francesco Chicchiriccò
On 15/10/2013 17:10, Sergey Beryozkin wrote: Hi On 15/10/13 15:13, Winnebeck, Jason wrote: I am using a tool called Enunciate to do this: http://enunciate.codehaus.org/index.html It's confusing at first because Enunciate generates interface definition documents (like WADL) but also wants to

Re: WADL documentation via Javadoc?

2013-10-15 Thread Daniel Kulp
Interesting…. We haven't really looked at anything javadoc related as that information isn't available at runtime. It's only available at build time and thus we'd need special tools and such to parse the javadoc at build time, output a file or something that can be picked up later. Jersey