Mailing-List: contact axis-dev-help@ws.apache.org; run by ezmlm
Precedence: bulk
Reply-To: axis-dev@ws.apache.org
Message-ID: <298958472.1101138692355.JavaMail.apache@nagoya>
Date: Mon, 22 Nov 2004 07:51:32 -0800 (PST)
From: =?ISO646-US?Q?S=3Fbastien_Tardif_=28JIRA=29?= <axis-dev@ws.apache.org>
To: axis-dev@ws.apache.org
Subject: [jira] Updated: (AXIS-1665) Axis do not generate JavaDoc for the
 service and port interface.
In-Reply-To: <99136086.1100298503805.JavaMail.apache@nagoya>
Mime-Version: 1.0
Content-Type: text/plain; charset=ISO-8859-1
Content-Transfer-Encoding: quoted-printable

     [ http://nagoya.apache.org/jira/browse/AXIS-1665?page=3Dhistory ]

S=E9bastien Tardif updated AXIS-1665:
-----------------------------------

    Attachment: docHarbor.wsdl

Here an example of a WSDL with full documentations in many sections of a WS=
DL.

> Axis do not generate JavaDoc for the service and port interface.
> ----------------------------------------------------------------
>
>          Key: AXIS-1665
>          URL: http://nagoya.apache.org/jira/browse/AXIS-1665
>      Project: Axis
>         Type: Bug
>   Components: Serialization/Deserialization
>     Versions: 1.0-rc1
>  Environment: CVS Nov 12 2004
>     Reporter: S=E9bastien Tardif
>  Attachments: docHarbor.wsdl, docHarbor.wsdl
>
> Title: Axis do not generate JavaDoc for the service and port interface.
> Service and Port are the entries points and so are quite important and sh=
ould have JavaDoc!
> I have a WSDL like this:
> ...
> <wsdl:service name=3D"DocHarborServices">
> =09<xsd:annotation>
> =09=09<xsd:documentation xml:lang=3D"en">Contain all operations in docHar=
bor Web Services. The mode of operation is stateless so you have to provide=
 a Credential instance to every operation.</xsd:documentation>
> =09</xsd:annotation>
> =09<wsdl:port name=3D"docHarbor" binding=3D"impl:webservicesSoapBinding">
> =09=09<xsd:annotation>
> =09=09=09<xsd:documentation xml:lang=3D"en">Contain all operations in doc=
Harbor Web Services. The mode of operation is stateless so you have to prov=
ide a Credential instance to every operation.</xsd:documentation>
> =09=09=09</xsd:annotation>
> =09=09<wsdlsoap:address location=3D"http://localhost/webservices1_0/servi=
ces/docHarbor"/>
> =09</wsdl:port>
> </wsdl:service> -->
> </wsdl:definitions>
> So I was expecting to see in those classes Javadoc having what I specifie=
d in xsd:documentation:
> docHarbor.java extract:
> // SHOULD HAVE JAVADOC HERE
> public interface DocHarbor extends javax.xml.rpc.Service {
>     public java.lang.String getdocHarborAddress();
> ...
> and
> DocHarborServices.java extract:
> // SHOULD HAVE JAVADOC HERE
> public interface DocHarborServices extends javax.xml.rpc.Service {
>     public java.lang.String getdocHarborAddress();
> I'm surprise because there are many bugs one JavaDoc issues and they are =
all Closed:
>   AXIS-1262  Pulling Javadoc from  Unassigned  Danno Ferrin     Closed  F=
ixed  24/Mar/04 24/Mar/04    Unwatch=20
>   AXIS-766  Generate JavaDoc comments from WSDL comments  Axis Developers=
 Mailing List  ted stockwell      Resolved  Duplicate  23/Mar/03 23/Feb/04 =
=20
>   AXIS-604  Generated comments should be javadoc comments  Unassigned  St=
eve Loughran      Closed  Fixed  08/Jan/03 23/Mar/04     =20
> I have attached the WSDL for reference.

--=20
This message is automatically generated by JIRA.
-
If you think it was sent incorrectly contact one of the administrators:
   http://nagoya.apache.org/jira/secure/Administrators.jspa
-
If you want more information on JIRA, or have a bug to report see:
   http://www.atlassian.com/software/jira