Re: XML API documentation



On Sat, 2002-11-09 at 18: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.

Is there any reason not to register these HTML docs with Scrollkeeper? 
After all, it's supposed to be a Documentation Metadata System, not a
DocBook Metadata System.
	Greg

-- 
Gregory Leblanc <gleblanc linuxweasel com>




[Date Prev][Date Next]   [Thread Prev][Thread Next]   [Thread Index] [Date Index] [Author Index]