Re: Doxygen + Python

Hi Marko,

We built the bindings with SWIG over 10+ years (now more than 600 classes
spread over 5 libraries) so it's a bit hard to construct a minimal example.
However, compared to the working Java+Doxygen bindings, I was able to find
the culprit which is this line in the interface file:
%feature("autodoc", "3");
which apparently takes precedence over the doxygen documentation. Not sure
if the interplay between the two is documented anywhere but just in case it
helps other users struggling with this issue.

All the best,
-Ayman



On Thu, Jul 22, 2021 at 1:50 AM Marko Klopcic <[email protected]>
wrote:

> Hi Ayman,
>
> Can you provide a minimal example?
>
> Regards,
>
>   Marko
>
> On 13 Jul 2021 16:27, Ayman Habib wrote:
>
> Hi all,
>
> I've migrated our libraries/bindings generation to SWIG version 4.0.2, in
> part to take advantage of the new doxygen documentation feature for Java
> and Python. For the same code/headers, I do get the doxygen documentation
> into all the generated java files successfully (despite some
> warnings/errors parsing doxygen comments) however most of the corresponding
> .py files have no documentation (except for a couple). Any idea how to
> troubleshoot this?  I understand python doesn't have the same set of
> javadoc options but this looks more like a parsing issue rather than
> translation issue (based on my use of the  -debug-doxygen-translator and
> -debug-doxygen-parser command line options).
>
> Thank much for all your help,
> -Ayman
> =========================
> Ayman Habib, Ph.D.
> Software Engineer, Research
> Stanford BioEngineering
> 318 Campus Drive West
> Stanford, CA 94305
> ========================
>
>
>
> _______________________________________________
> Swig-user mailing [email protected]://lists.sourceforge.net/lists/listinfo/swig-user
>
>
> _______________________________________________
> Swig-user mailing list
> [email protected]
> https://lists.sourceforge.net/lists/listinfo/swig-user
>

_______________________________________________
Swig-user mailing list
[email protected]
https://lists.sourceforge.net/lists/listinfo/swig-user