cxf-issues mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Francesco Chicchiriccò (JIRA) <j...@apache.org>
Subject [jira] [Updated] (CXF-5353) WADLGenerator needs to support existing JavaDocs when possible
Date Tue, 31 Dec 2013 08:00:55 GMT

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

Francesco Chicchiriccò updated CXF-5353:
----------------------------------------

    Attachment: Syncope-trunk-CXF-5353.patch

This patch can be applied to current Syncope trunk to check if WADL contains Javadocs elements.

{code}
$ svn co https://svn.apache.org/repos/asf/syncope/trunk syncope-trunk
$ cd syncope-trunk
$ patch -p0 < /path/to/Syncope-trunk-CXF-5353.patch
$ mvn -PskipTests
$ cd core
$ mvn -Pdebug
{code}

At this point you can access http://localhost:9080/syncope/rest/?_wadl and check the generated
WADL.

> WADLGenerator needs to support existing JavaDocs when possible
> --------------------------------------------------------------
>
>                 Key: CXF-5353
>                 URL: https://issues.apache.org/jira/browse/CXF-5353
>             Project: CXF
>          Issue Type: Improvement
>            Reporter: Sergey Beryozkin
>         Attachments: Syncope-trunk-CXF-5353.patch
>
>
> CXF @Description annotations targeting a given resource method (method itself and its
in and response parameters) will often duplicate what the existing JavaDocs have already documented.

> WADLGenerator needs to do the best effort in trying to incorporate JavaDocs into the
generated document.



--
This message was sent by Atlassian JIRA
(v6.1.5#6160)

Mime
View raw message