Re: Extending Doxygen to support other languages?

On Wed, Jan 10, 2007 at 09:45:53PM -0800, Jason McKesson wrote:

> 2: Replace the refactored objects in the document generation code. 
> Preferably, generate a single XML file that can be processed by XML 
> tools (whether C++ applications or XSLT transforms) that represents this 
> data, which is used as the source for generating all other formats.

That's the bit I'm interested in, if we have an XML output which
contains everything we need then we can easily (relatively, at least)
produce man pages, TexInfo (FSF/GNU), HTML, TeX, RTF or anything else
from it, in formats which match whatever we need (to meet
company-imposed documentation standards, for instance).

> To be honest, I could do steps 1 & 2. Indeed, I had to do some of that 
> in order to be able to talk to Doxygen in a reasonably coherent way. 1 & 
> 2 would be somewhat straightforward. And I would certainly be willing to 
> supply XSLTs for generating various kinds of output formats. HTML and 
> XSL-FO would be my personal specialties, but they probably wouldn't look 
> very "Doxygen style".

I would be very interested in your steps 1 and 2.  I did some hacking of
the man page generator quite a time ago, and it was painful trying to
work out where everything was.  Not that I'm all that familiar with XSLT
yet but it is at least a standard transform.  I tried to do a converter
from the existing (not yours) XML output to TexInfo but some of the
information was either not there or not sensibly accessible.

> Step 3 would require far more familiarity with how the parser builds the 
> documented code than I have or want. And steps 4-6 are well outside of 
> my league.

Like you I dont know the parser, my brief looks at it have been not
promising.  But I also don't need the parser to do much more than it
already does (I don't need it for other languages, for instance) so I
don't have the motivation to go into it in depth.

Chris C

-------------------------------------------------------------------------
Take Surveys. Earn Cash. Influence the Future of IT
Join SourceForge.net's Techsay panel and you'll get the chance to share your
opinions on IT & business topics through brief surveys - and earn cash
http://www.techsay.com/default.php?page=join.php&p=sourceforge&CID=DEVDEV