On 24 Mar 2011, at 13:17, Sergey Beryozkin wrote: > I was just thinking about it :-)... I'm wondering, would it make sense to > update the class for the annotation be applicable to parameters as well ? > Probably yes, what do you think ?
There is also the issue whereby at the moment one cannot document response objects. For example: <method name="GET"> <doc>Retrieve object data</doc> <response status="200"> <doc>Get data about an existing object</doc> <representation /> </response> <response status="404"> <doc>Request for object that does not exist </doc> <representation /> </response> </method> But this goes to a wider issue that any wadl element can have a doc element attached and obviously we are limited with what and where we can annotate. Matt > > Cheers, Sergey > > > On Thu, Mar 24, 2011 at 1:10 PM, Matthew Glubb <[email protected]> wrote: > >> Ah. Brilliant. Thanks Sergey. From that annotation class, it doesn't look >> like I can document param elements. Is that correct? >> >> >> Matt >> >> >> Matthew Glubb >> Technical Partner >> >> email: [email protected] >> phone: 44 (0) 7715 754017 >> skype: mglubb >> >> Kite >> http://madebykite.com >> >> -- >> GPG: 96FF DE0E 0B7B 37F0 7F8D C54C E285 3D8F 5625 9244 >> >> On 24 Mar 2011, at 12:53, Sergey Beryozkin wrote: >> >>> Hi >>> >>> On Thu, Mar 24, 2011 at 12:46 PM, Matthew Glubb <[email protected]> >> wrote: >>> >>>> Hi, >>>> >>>> I'm trying to get javadoc documentation added to an auto-generated wadl. >> Is >>>> this possible? Is it possible to document the wadl using annotations >>>> instead? >>>> >>>> >>> Yes, please check >>> >>> >> http://cxf.apache.org/docs/jaxrs-services-description.html#JAXRSServicesDescription-DocumentingresourceclassesandmethodsinWADL >>> >>> Cheers, Sergey >>> >>> >>>> Thanks, >>>> >>>> >>>> Matt >>>> >>>> >>>> Matthew Glubb >>>> Technical Partner >>>> >>>> email: [email protected] >>>> phone: 44 (0) 7715 754017 >>>> skype: mglubb >>>> >>>> Kite >>>> http://madebykite.com >>>> >>>> -- >>>> GPG: 96FF DE0E 0B7B 37F0 7F8D C54C E285 3D8F 5625 9244 >>>> >>>> >> >>
