Subject: RE: Another Manual ???
To: None <jwjr@panix.com>
From: Andrew Crossley <toast@iinet.net.au>
List: netbsd-users
Date: 01/22/2000 04:30:55
Excuse my ignorance, but why is Perl a dirty word (might make interesting
readingin my book - it sure does on this list !! :-)
XiT
-----Original Message-----
From: netbsd-users-owner@netbsd.org
[mailto:netbsd-users-owner@netbsd.org]On Behalf Of James Wetterau
Sent: Saturday, 22 January 2000 4:24 AM
To: tls@rek.tjls.com
Cc: netbsd-users@netbsd.org
Subject: Re: Another Manual ???
Thor Lancelot Simon says:
> > 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.
...
Hey, I didn't say Perl should be included with the NetBSD
distribution. I didn't say I thought Perl should be included with the
NetBSD distribution. I didn't say that Perl's documentation system
should be included with the NetBSD system. OK?
I especially didn't say I wanted a fight. And how would my engaging
in fisticuffs have anything to do with Perl's inclusion in or
exclusion from the NetBSD distribution? You're ranting at me for no
good reason.
I said I thought POD has some good ideas, specifically its simplicity
and utility in generating other formats. I pointed out in what man
pages you can find out about those features. The man page I spoke of
is available via the NetBSD Packages collection. And I stand by my
claim that whatever system NetBSD documentation gets written in could
take a lesson or two from the simplicity and flexibility of the POD
system.
There's no need to fly off the handle and start ranting about fist
fights.
All the best,
James