From mboxrd@z Thu Jan  1 00:00:00 1970
Received: from euclid.skiles.gatech.edu (euclid.skiles.gatech.edu [130.207.146.50]) by melb.werple.net.au (8.7.4/8.7.3) with ESMTP id LAA19470 for <mason@werple.mira.net.au>; Sat, 16 Mar 1996 11:25:20 +1100 (EST)
Received: (from list@localhost) by euclid.skiles.gatech.edu (8.7.3/8.7.3) id TAA26821; Fri, 15 Mar 1996 19:14:24 -0500 (EST)
Resent-Date: Fri, 15 Mar 1996 19:14:24 -0500 (EST)
Message-Id: <199603160012.TAA26873@redwood.skiles.gatech.edu>
X-Mailer: exmh version 1.6.5 12/11/95
To: Mark Borges <mdb@cdc.noaa.GOV>
cc: ZSH mailing list <zsh-workers@math.gatech.edu>
Subject: Re: ZSH presence on WWW cf. Perl 
In-reply-to: Your message of "Fri, 15 Mar 1996 16:56:54 MST."
             <9603152356.AA07279@suomi.cdc.noaa.gov> 
Mime-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Date: Fri, 15 Mar 1996 19:12:40 -0500
From: "Richard J. Coleman" <coleman@math.gatech.edu>
Resent-Message-ID: <"S8lM43.0._Y6.WVWIn"@euclid>
Resent-From: zsh-workers@math.gatech.edu
X-Mailing-List: <zsh-workers@math.gatech.edu> archive/latest/829
X-Loop: zsh-workers@math.gatech.edu
Precedence: list
Resent-Sender: zsh-workers-request@math.gatech.edu

> With the release of perl-5.002 came a much better (IMO at least)
> organization. There are several aspects I like about it -- the broad
> categories, the update time-stamps, the diversions.
> 
> I think it could serve as good boilerplate material for zsh. Not
> that there is anything seriously wrong with the zsh page at present
> -- it's certainly functional. But I'm getting bored with it.

Yes, these pages are very nice.  Using them as a base for changes
to the zsh web pages is a good idea.

> In particular, I'd like to suggest that the baseline documentation be
> converted to something other than nroff, such as perlpod. Before you
> yell and flame back, wait...

I have looked at pod (and SGML, and other things) several times.
One of the things I don't like about pod, is that you can't put
things like boldface/italics in code examples.  The zsh pages uses
this quite a bit.

I agree that nroff is terrible.  I've been thinking maybe it's time
to scrap man pages altogether.  Put all the documentation into a
latex file, and create a nice zsh manual.

rc