Re: XML API documentation

[MArk Finlay <sisob eircom net>]

On Sun, 2002-11-10 at 02:13, Malcolm Tredinnick wrote:
> On Sun, Nov 10, 2002 at 12:13:27PM +1100, Malcolm Tredinnick wrote:
> > On Sat, Nov 09, 2002 at 07:18:33AM -0700, John Fleck wrote:
> > > On Sat, 2002-11-09 at 04:35, Malcolm Tredinnick wrote:
> > [...]
> > > > Further, should we just bite the bullet and do this for all API
> > > > documentation for GNOME 2.2?
> > > 
> > > Would it be possible to set up a omf files at the same time so the API
> > > docs are registered with ScrollKeeper?
> > 
> > I really should see these traps coming. :-)
> > 
> > Yes, it's possible. Just have to think of the neatest way to do it.
> 
> Scrub that. It doesn't make sense. The API documentation is distributed
> as HTML, not XML. The change I want to make is to use a feature of
> gtk-doc which uses XML as the intermediate step (comments + templates
> --> XML --> HTML). The middle step used to be SGML and then used
> openjade to generate the HTML. The XML changes that James made just
> means we use xsltproc to create the HTML.

would it not be really useful to have API docs in a category in yelp?

-- 
		 .--= [ MArk Finlay - sisob ] =--.

	   [ My Weblog: http://advogato.org/person/sisob ]
        [ Gnome User's Board : www.gnomesupport.org/forums ]
     [ Want to be a Hacker?: http://www.tuxedo.org/~esr/faqs/ ]