Using asphyxiate with Doxygen and Java?

Using asphyxiate with Doxygen and Java?

[Noah Watkins]

I stumbled upon Breathe, and then asphyxiate. The doxygenfile
directive in the later doesn't seem to like what Doxygen produces from
parsing JavaDoc markup, although I've read that the Doxygen produced
should be compliant. Here is the error:

   AssertionError: cannot handle compounddef kind=class

Before going any further and I wanted to ping the list to see if
anyone thinks it would be a good/bad idea to look into this. It'd be
nice to have the Java documentation in Sphinx seamlessly. Any change
Breathe has gotten faster over time?

THanks,
Noah

Re: Using asphyxiate with Doxygen and Java?

[Josh Durgin]

On 10/26/2012 06:26 PM, Noah Watkins wrote:
> I stumbled upon Breathe, and then asphyxiate. The doxygenfile
> directive in the later doesn't seem to like what Doxygen produces from
> parsing JavaDoc markup, although I've read that the Doxygen produced
> should be compliant. Here is the error:
>
>     AssertionError: cannot handle compounddef kind=class

Asphyxiate was written quickly to handle most of the markup used in
the librados C API documentation. Of course, this didn't include any
classes. It shouldn't be too difficult to add support for them,
or other markup, to asphyxiate. I can help with this if you like.

> Before going any further and I wanted to ping the list to see if
> anyone thinks it would be a good/bad idea to look into this. It'd be
> nice to have the Java documentation in Sphinx seamlessly. Any change
> Breathe has gotten faster over time?

It doesn't look like there's been much activity there in the last year.

> THanks,
> Noah

Re: Using asphyxiate with Doxygen and Java?

[Mark Kampe]

TV is of the opinion that Asphyxiate was the right
direction to move in, and that the sloth problems
are solvable, but would require work.

On 10/26/2012 6:26 PM, Noah Watkins wrote:
> I stumbled upon Breathe, and then asphyxiate. The doxygenfile
> directive in the later doesn't seem to like what Doxygen produces from
> parsing JavaDoc markup, although I've read that the Doxygen produced
> should be compliant. Here is the error:
>
>     AssertionError: cannot handle compounddef kind=class
>
> Before going any further and I wanted to ping the list to see if
> anyone thinks it would be a good/bad idea to look into this. It'd be
> nice to have the Java documentation in Sphinx seamlessly. Any change
> Breathe has gotten faster over time?

Re: Using asphyxiate with Doxygen and Java?

[Noah Watkins]

Great, thanks guys. I'll see how far I get extending it to handle Java elements.

On Sat, Oct 27, 2012 at 8:57 AM, Mark Kampe <mark.kampe@inktank.com> wrote:
> TV is of the opinion that Asphyxiate was the right
> direction to move in, and that the sloth problems
> are solvable, but would require work.
>
>
> On 10/26/2012 6:26 PM, Noah Watkins wrote:
>>
>> I stumbled upon Breathe, and then asphyxiate. The doxygenfile
>> directive in the later doesn't seem to like what Doxygen produces from
>> parsing JavaDoc markup, although I've read that the Doxygen produced
>> should be compliant. Here is the error:
>>
>>     AssertionError: cannot handle compounddef kind=class
>>
>> Before going any further and I wanted to ping the list to see if
>> anyone thinks it would be a good/bad idea to look into this. It'd be
>> nice to have the Java documentation in Sphinx seamlessly. Any change
>> Breathe has gotten faster over time?
>
>