breathe-doc / breathe

ReStructuredText and Sphinx bridge to Doxygen
https://breathe-doc.org
Other
753 stars 201 forks source link

Using just the Parser as part of another application #66

Closed superlou closed 11 years ago

superlou commented 11 years ago

Is it possible to use just the breathe.parser package to parse Doxygen XML so that I can render the output differently (into a Word document with specific formatting)? Would be very appreciative a quick example. I'm creating a DoxygenParserFactory and index parser, but am not sure what the role of the cache and file_state_cache are.

michaeljones commented 11 years ago

Hi superlou,

Very happy to help you with this but I'm a little busy until this weekend. Mind if I spend some time on it then?

I can't say that I have designed things with that in mind, but I do like to try to keep things modular and independent so it should be possible.

The parsing code is largely generated with this:

http://www.rexx.com/~dkuhlman/generateDS.html

It might be worth investigating using that directly to see if it works for you. The results weren't perfect so there are some potentially useful changes in the Breathe code base but then the generateDS tool may have improved since I used it for Breathe as well.

Cheers, Michael

michaeljones commented 11 years ago

Hi,

I have some more time now but you have been a little quiet :) Let me know if you would still like some help, otherwise I'll assume you've found your own way.

Cheers, Michael

michaeljones commented 11 years ago

Closing due to inactivity. Please re-open it if you would like to continue with this idea.