Re: GNOME Documentation Framework
- From: Scott Wimer <scottw dev cgibuilder com>
- To: Federico Mena Quintero <federico nuclecu unam mx>
- cc: gnome-list gnome org
- Subject: Re: GNOME Documentation Framework
- Date: Fri, 16 Oct 1998 13:59:07 -0700 (PDT)
I'm making the API documentation extractor a 2 piece process. The first
strips a block of docu-comments out (whether that's comments about a single
function, or a whole module -see John's later email). This information
gets passed off to some other (probably externally chosen) module that
handles the actual formatting of the data, for some particular target.
I have been thinking about using Welder for that second piece, and just
writing various Welder plugins for each output document format: ie,
one for DocBook, maybe another for HTML, a third for man, or whatever.
Initially, I plan on just making the second part only do DocBook (without
Welder's intervention). Afterwords, I'll find out what other formats
people want to be able to grab the information in.
On Fri, 16 Oct 1998, Federico Mena Quintero wrote:
> > I've written a tool that may be useful once somebody has built the
> > various templates. Basically, it makes it easy to glue templates and
> > the data for them (even if it comes from various different sources)
> > together into an output file. The tool is called Document Welder. You
> > can grab it from http://www.cgibuilder.com/welder/ if you want to take
> > a look at it.
> Hey, this looks pretty cool. I think it would be very nice to use it
> with the DocBook templates we have in the documentation framework.
> Please tell us your thougts about how it would/should work :-)
> To unsubscribe: mail firstname.lastname@example.org with
> "unsubscribe" as the Subject.
play ---> email@example.com http://www.cgibuilder.com/
work ---> firstname.lastname@example.org http://www.earthlink.net/
] [Thread Prev