You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@openmeetings.apache.org by "Maxim Solodovnik (JIRA)" <ji...@apache.org> on 2012/07/18 21:56:03 UTC
[jira] [Closed] (OPENMEETINGS-106) JabberService is missing in the
API Doclet task that generates the SOAP/REST API Documentation
[ https://issues.apache.org/jira/browse/OPENMEETINGS-106?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel ]
Maxim Solodovnik closed OPENMEETINGS-106.
-----------------------------------------
Closing all old 'Resolved' issues
> JabberService is missing in the API Doclet task that generates the SOAP/REST API Documentation
> ----------------------------------------------------------------------------------------------
>
> Key: OPENMEETINGS-106
> URL: https://issues.apache.org/jira/browse/OPENMEETINGS-106
> Project: Openmeetings
> Issue Type: Task
> Components: SOAP/REST API
> Affects Versions: 2.0 Apache Incubator Release
> Reporter: SebastianWagner
> Assignee: Maxim Solodovnik
> Fix For: 2.0 Apache Incubator Release
>
>
> the JabberService is missing in the API Doclet task that generates the SOAP/REST API Documentation... well maybe some documentation from my side is also missing how that thing works :)
> How to enable a new webservice in the doc tool:
> 1) You need to add the class JabberWebService in the Ant targets: build.webservice.doc, build.only.webservice.doc
> 2) You need to add regular java-doc to each function and to the class itself describing each parameter and a short description of the method/class like in FileWebService for example (you will see a warning info text in the generated docs if the java-doc doesn't match method's parameter count)
> 3) You need to slightly change the template so that the links to the newly created WebService is visible in the generated docs: In docs/ApiMethodsTemplate.vm you need to change the height of the iFrame from 140 maybe to 180
> Btw: There are two velocity templates in the docs folder ApiMethodsTemplate.vm and ApiClassesTemplate.vm that are needed to generate the SOAP/REST API docs. If you are going to remove the generated "docs" folder those velocity template files should be moved somewhere else and the Doclet task has to be changed to the new paths.
--
This message is automatically generated by JIRA.
If you think it was sent incorrectly, please contact your JIRA administrators: https://issues.apache.org/jira/secure/ContactAdministrators!default.jspa
For more information on JIRA, see: http://www.atlassian.com/software/jira