Subject: Re: On more flavorful markup for NetBSD software documentation
To: Christopher Reid Palmer <>
From: Hubert Feyrer <>
List: tech-kern
Date: 07/20/2000 00:30:35
On Wed, 19 Jul 2000, Christopher Reid Palmer wrote:
> 1. Decide on a document format
>   LaTeX
>   DocBook
>   Some pre-existing XML DTD
>   Some new XML DTD

It's already been decided to be DocBook. If this thread would appear on a
"proper" list, someone would probably have told you earlier. ;)

> 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)

pkgsrc/meta-pkgs/netbsd-doc and .../netbsd-doc-print is what you'll need
to convert DocBook->HTML and PS/PDF. 

I haven't followed this thread so far, but if someone wants to further
discuss things, I'd suggest we move this to a more appropriate location
(either tech-userlevel or netbsd-advocacy?).

 - Hubert

NetBSD - because Unix isn't just #include <linux.h>, i386, ILP32, ELF, ...!