axis-c-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Samisa Abeysinghe <samisa_abeysin...@yahoo.com>
Subject RE: API doc generation with Doxygen
Date Wed, 16 Jun 2004 03:54:41 GMT
May be the problem is that there are 2 classes/structs in the header file.
I think doxygen is capable of hadling this situation.
If not we can move the classes to seperate headers.

Thanks,
Samisa...

--- Susantha Kumara <susantha@opensource.lk> wrote:
> Hi Samisa,
> 
> I checked the doxygen comments. But I could not yet locate the problem.
> I will try to locate the problem ASAP.
> 
> ---
> Susantha
> 
> > -----Original Message-----
> > From: Samisa Abeysinghe [mailto:samisa_abeysinghe@yahoo.com]
> > Sent: Tuesday, June 15, 2004 1:00 PM
> > To: Apache AXIS C Developers List
> > Subject: RE: API doc generation with Doxygen
> > 
> > Hi Susantha,
> >     Is it possible for you to fix the problems.
> >     I cannot still generate the docs.
> > Thanks,
> > Samisa
> > 
> > 
> > --- Susantha Kumara <susantha@opensource.lk> wrote:
> > > Hi Samisa,
> > >
> > > I think this has happened with my commit with documentation of
> Parser
> > > and Transport related header files. Actually I did not try to
> generate
> > > the API documentation with doxygen before commiting. I only compiled
> and
> > > ran Axis to verify that it works and commited. I apologize for any
> > > inconvenience caused.
> > >
> > > Shall we make the tradition from now on that any developer should
> also
> > > run doxygen any verify correct API doc generation before commiting.
> > >
> > >
> > > > -----Original Message-----
> > > > From: Samisa Abeysinghe [mailto:samisa_abeysinghe@yahoo.com]
> > > > Sent: Tuesday, June 15, 2004 8:46 AM
> > > > To: Apache AXIS C Developers List
> > > > Subject: API doc generation with Doxygen
> > > >
> > > > Hi,
> > > >     I updated the Stub.h and made sure the API doc comments work
> with
> > > > doxygen.
> > > >
> > > >     However the latest changes done on the file by someone else
> has
> > > made
> > > > the doxygen tool not to
> > > > pick the comments and does not generate properly.
> > >
> > > That was my mistake. I am sorry for that.
> > >
> > > >     This is the second time around that the work done by me was
> made
> > > non
> > > > functional. (the earlier
> > > > situation was in case of the WSDL2WS tool)
> > > >     I think we better have some diciplined testing before commits
> are
> > > > made.
> > >
> > > Yes this is not the first time that this has happened. I today found
> > > that WSDL2Ws tool does not generate the default constructor of
> client
> > > side stub with the endpoint taken from the WSDL. Some one has
> removed
> > > that part of code in WSDL2Ws tool.
> > >
> > > We have to avoid happening these in the future.
> > >
> > > >
> > > >     In case of doxygen please make sure to verify that documents
> are
> > > > generated properly.
> > > >
> > > >     Additionally, I cannot locate docs related to Transport
> > > abstraction
> > > > and parser abstraction
> > > > within the API docs generated.
> > > >
> > > >     I am kind of frustrated on the amount of rework/rechecks that
> I
> > > have
> > > > to do. Please fix the
> > > > Stub/parser abstraction and trasport abstraction documentation, so
> > > that
> > > > users could program using
> > > > those.
> > > >
> > > > Thanks,
> > > > Samisa...
> > > >
> > >
> > > Thanks,
> > > --
> > > Susantha Kumara
> > > Lanka Software Foundation
> > > Office : +94112591785
> > > Mobile : +94777420453
> > >
> > >
> > 
> > 
> > 
> > 
> > 
> > __________________________________
> > Do you Yahoo!?
> > Friends.  Fun.  Try the all-new Yahoo! Messenger.
> > http://messenger.yahoo.com/
> 
> 



		
__________________________________
Do you Yahoo!?
Yahoo! Mail Address AutoComplete - You start. We finish.
http://promotions.yahoo.com/new_mail 

Mime
View raw message