Re: XML API documentation
- From: Gregory Leblanc <gleblanc linuxweasel com>
- To: GNOME Desktop Hackers <desktop-devel-list gnome org>
- Cc: gnome-doc-list gnome org
- Subject: Re: XML API documentation
- Date: 09 Nov 2002 18:51:51 -0800
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]