On Tue, 20 Mar 2012 13:20:09 +0100 Stefan Radomski <swig@...> wrote:
SR> I was wondering if anyone can comment on the state of the "doxygen to
SR> javadoc" development branch in  - are there any plans to merge it
SR> into an upcoming swig release?
Unfortunately I don't know anything about its state, hopefully William
would know more. I'm mostly replying just to show that there is some
interest in this project...
SR> We are using SWIG to wrap a C++ codebase per JNI and it would be really
SR> nice if our Java developers could automatically benefit from the
SR> doxygen documentation. I see that the current JavaDoc approach is
SR> somewhat of a kludge  and would require to have the documentation
SR> twice - which will inevitably lead to out-of-date documentation.
Absolutely. Being able to reuse Doxygen comments in C++ in the target
language would be great and ideal would be to have it not only for Java but
for the other languages too. And at least for C# (which is remarkably
similar to Java in many aspects) it shouldn't be too difficult. In theory
it should be also possible to generate Python doc strings and Perl POD &c
from Doxygen comments but this would probably be much more difficult so I
don't know if it's worth it.