Re: [docbook-apps] using docbook for API reference documentation

[David Holroyd <lists.oasis-open.org@badgers-in-foil.co.uk>]

On Fri, Apr 07, 2006 at 09:30:26AM -0400, Stefan Seefeld wrote:
> I have been a happy docbook user for many years. A couple of years ago
> I started to write a tool to generate docbook-formatted documentation
> from scanning source code, as part of the synopsis project
> (http://synopsis.fresco.org).

Snap!  I've been writing an API-documenter for ActionScript.  I haven't
got any further than HTML output yet, though.


> Are there any online resources that discuss useful mappings ? Are
> there existing tools (such as doxygen or similar) that generate
> docbook ? What docbook conventions do projects such as KDE and GNOME
> use for their APIs ?

Have you looked at the output of the dbdoclet for Java?

  http://dbdoclet.org/

I plan to investigate it properly at some point.


dave

-- 
http://david.holroyd.me.uk/