Subject: Re: On more flavorful markup for NetBSD software documentation
To: Christopher Reid Palmer <chrisp@dusk.bitstream.net>
From: Tino Wildenhain <tino@wildenhain.de>
List: tech-kern
Date: 07/19/2000 21:50:04
Hi,
Christopher Reid Palmer wrote:
>
*snip*
>
> Here is a (possibly incomplete) list of tasks for which I am volunteering
> myself (and anyone else who is interested):
>
> 1. Decide on a document format
> LaTeX
> DocBook
> Some pre-existing XML DTD
> Some new XML DTD
I can help here, if you want.
>
> 2. Find and/or develop software
> For converting from (1) to online and printable docs, either
> interactively (xml2man, a CGI script, et c.), as a batch job, or
> both. This might entail programs like man(1) becoming
> wrappers/front-ends to the translator(s)
Some of them are already available. There are many parsers and
libraries around, SAX as example (not only in java, if someone
is afraid ;)
> 3. QA/Testing
> How bad does it suck? In what ways could it be made to suck less?
> Find willing testers
>
> 4. Refine per (3)
>
> 5. Repeat (2-4) until happy
>
> 5. Ship
> Commit to CVS
> ..
>
> Thoughts?
I feel we should move this discussion/project somewhere else, since
it is not tech-kern related furthermore.
Regards
Tino Wildenhain