[
https://issues.apache.org/jira/browse/CXF-5353?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=13861529#comment-13861529
]
Francesco Chicchiriccò commented on CXF-5353:
---------------------------------------------
Hi,
I've just tested the updated version, reviewed all javadocs and committed
(hence no more patching on Syncope is required to test the current issue).
Currently Javadocs are correctly picked up, with a noticeable exceptions:
methods with no params (like as {{ConfigurationService#list}}). Is there
anything I am missing or is this just a bug?
I understand the policy about using {{@Description}} for non-plaintext content:
would it be possible to use a mixed approach? For example I only need
{{@Description}} for {{DocTarget.RETURN}} in few methods like as
{{SchemaService#create}}, but would like to still pick the remaining
information from Javadocs.
I have also fixed the 'duplicated schemas' problem: I was simply missing some
{{package-info.java}} files from new packages.
Enjoy your vacation!
Regards.
> 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)
