Subject: Re: Another Manual ???
To: None <netbsd-users@netbsd.org>
From: Thor Lancelot Simon <tls@rek.tjls.com>
List: netbsd-users
Date: 01/21/2000 15:05:17
On Fri, Jan 21, 2000 at 02:22:05PM -0500, James Wetterau wrote:
>
> Curt Sampson says:
> > On Fri, 21 Jan 2000, Matthew Orgass wrote:
> >
> > > * I think it would be a good idea to convert the man pages to DocBook.
> > > SGML is *much* nicer to read then roff and can be additionally marked up
> > > for more expressive medium.
> >
> > I'm pretty much in agreement that troff has probably got to go if
> > we're going to have folks who haven't been using Unix since 1980 doing
> > signifcant work on the documentation. Heck, I used to do *everything*
> > in troff, including personal letters, but even I can't stand it now.
> ...
>
> I'm awfully fond of Perl's POD (plain old documentation) system for
> writing documentation. It is not a general purpose system for text
Perl is not -- and will not be, unless you want to engage in fisticuffs
with a substantial number of the current NetBSD developers -- included
in NetBSD.