-
Notifications
You must be signed in to change notification settings - Fork 87
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Support java interfaces? #93
Comments
Hi, the Doxygen XML output processing was originally tailored to C and C++ and I'm afraid adding support for Java is more than just fixing the asserts -- the output templates would need to get updated as well, since you definitely do not want to have Java On a related note, as a longer-term project I'm planning to extend the script to support C# (#76) and Python (#80), however taking a bit different approach there -- instead of relying on Doxygen (and all its misfeatures / parser bugs), introspecting the C# / Python APIs directly via reflection (using IronPython for C#) and taking the documentation strings from there as well, instead of attempting to parse the sources directly. I didn't investigate what is the equivalent introspection / docblock extraction API in Java, but I'm sure there is something as well. In my opinion this is a more viable solution in the long-term than relying on Doxygen for parsing. Unfortunately at the moment I have no time to look into this. The Python support from #80 is currently at the top of my priority list and things I'll be doing for it could benefit the potential future Java support, but that's about it I'm afraid -- I can't even give you an estimate when I could take a look at this, sorry. Too many things to do, too little time :) |
Got it, totally understand. So many interesting projects and tasks in this life, and not enough time to get to them all! Glad to see you prioritizing the important things for you and the project. Best of luck with the python side of things! I'll close this issue out for now, and if you ever decide to get to this we can always reopen 😄 |
Keeping the issue open doesn't cost me any time, fortunately :) I'll reopen this to avoid people opening the same issue again. And if it stays open, there's a non-zero chance someone chimes in and suggests a way how to implement this using some Java introspection. |
Hi @mosra,
Thanks for putting this together. I'm trying to use this with a codebase that relies on a java interface (source here) and I'm seeing a crash at
m.css/doxygen/dox2html5.py
Line 3115 in a02eeab
I did some digging and it looks like the XML is correctly showing that the
kind
is aninterface
. Can this code path be fixed without too much trouble?Sample of generated XML
The text was updated successfully, but these errors were encountered: