[Insight-users] WrapITK and Java Bindings

[Gaëtan Lehmann]

Le 24 nov. 09 à 10:58, Julien Michel a écrit :

> Gaetan, Luis,
>

Hi Julien,

> Just to let you know, I managed to update the itk_doxy2swig.py  
> script so as to get the doxygen information imported into javadoc  
> comments in the java proxy classes. I am only missing a few things :
> - gccxml (ot pygccxml) seems to strip newlines so the imported doc  
> is a little compact (hard to read)

gccxml, pygccxml and igenerator.py are fully reconstructing the  
classes definitions. They are not manipulating the documentation at all.
The problem is more likely in itk_doxy2swig.py or in swig.

> - I have trouble tranlating the \See to @see, since the name of  
> classes changes (because of mangling)

yes, it would be a bit hard to revert an c++ class name to a class  
name available in java, at least because there are often several  
classes in java for one class in c++

> - Something more annoying : sometimes the proxy classes does not  
> inherit from its real superclass but rather from myClass_Superclass,  
> which has no documentation. Therefore, the inheritance scheme in  
> javadoc is broken.

We should have the doc for those class as well - it looks like a bug  
in the doc translation process.
I'll try to have a look.

> - For now I did not tranlate \param to @param and \return to @return
>
> Any idea on how to fix those points ? I shall send you a patch as  
> soon as these points have been adressed.


Would you agree to share your changes before everything is fixed?
It would make things easier to review :-)

Gaëtan

-- 
Gaëtan Lehmann
Biologie du Développement et de la Reproduction
INRA de Jouy-en-Josas (France)
tel: +33 1 34 65 29 66    fax: 01 34 65 29 09
http://voxel.jouy.inra.fr  http://www.itk.org
http://www.mandriva.org  http://www.bepo.fr

-------------- next part --------------
A non-text attachment was scrubbed...
Name: PGP.sig
Type: application/pgp-signature
Size: 203 bytes
Desc: Ceci est une signature ?lectronique PGP
URL: <http://www.itk.org/pipermail/insight-users/attachments/20091124/888756ce/attachment-0001.pgp>