[Insight-users] WrapITK and Java Bindings

[Julien Michel]

Gaëtan Lehmann a écrit :

> 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.

Well, itk_doxy2swig.py is parsing xml documentation file to build python 
docstrings (and now javadoc). I was assuming that these xml doc files 
were produced by gccxml or pygccxml (but I might be wrong).

>> - 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.

Well, it sounds more like a bug (or a feature ? ;)) from swig to me.

For instance :

itkAtanImageFilterIIF2_IIF2 is inheriting from 
itkAtanImageFilterIIF2_IIF2_Superclass, which should rather be 
itkUnaryFunctorImageFilterIIF2_IIF2_Tan or something like this.

Maybe it is just a problem of mangling ...

Julien
-- 
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

Julien MICHEL - Ingénieur d'études - Traitement d'images
CS Systèmes d'Information - Division ESPACE
Département Information Géographique & Image
Téléphone : +33 561 17 64 27
Email : julien.michel at c-s.fr

~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~