You are viewing a plain text version of this content. The canonical link for it is here.
Posted to issues@cxf.apache.org by "Francesco Chicchiriccò (JIRA)" <ji...@apache.org> on 2013/12/31 09:02:52 UTC
[jira] [Comment Edited] (CXF-5353) WADLGenerator needs to support
existing JavaDocs when possible
[ https://issues.apache.org/jira/browse/CXF-5353?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=13859403#comment-13859403 ]
Francesco Chicchiriccò edited comment on CXF-5353 at 12/31/13 8:01 AM:
-----------------------------------------------------------------------
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.
[~sergey_beryozkin], unfortunately latest changes don't make any difference.
was (Author: ilgrosso):
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)