From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from euclid.skiles.gatech.edu (list@euclid.skiles.gatech.edu [130.207.146.50]) by melb.werple.net.au (8.7.4/8.7.3) with ESMTP id LAA19218 for ; Sat, 16 Mar 1996 11:07:40 +1100 (EST) Received: (from list@localhost) by euclid.skiles.gatech.edu (8.7.3/8.7.3) id SAA26578; Fri, 15 Mar 1996 18:57:59 -0500 (EST) Resent-Date: Fri, 15 Mar 1996 18:57:59 -0500 (EST) Date: Fri, 15 Mar 1996 16:56:54 -0700 Message-Id: <9603152356.AA07279@suomi.cdc.noaa.gov> From: Mark Borges To: ZSH mailing list Subject: ZSH presence on WWW cf. Perl Organization: CIRES, University of Colorado X-Attribution: mb Resent-Message-ID: <"o-EBA1.0.9V6.6GWIn"@euclid> Resent-From: zsh-workers@math.gatech.edu X-Mailing-List: archive/latest/828 X-Loop: zsh-workers@math.gatech.edu Precedence: list Resent-Sender: zsh-workers-request@math.gatech.edu [It's late Friday afternoon -- too late to do any real work ] Hey-- Has anyone seen the Perl WWW page lately? It's at http://www.perl.com/perl/ 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. 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 do think it's very important to have a current, up-to-date, good old man page for zsh; I'm just not convinced nroff is the best source. In fact, after viewing the perl page, I'm far from convinced. The frame interface for the documentation, at ftp://uiarchive.cso.uiuc.edu/pub/lang/perl/CPAN/doc/manual/html/frames.html -- if your browser/machine can withstand the bombardment -- is pretty powerful for navigating the documentation. (I think Tom had must've had some graduate slavery in addition to pod2html here.) Further, POD is easy to type, which is important because documentation updates would be far more likely to be bundled with the patches. I know, POD is somewhat restrictive on the embellishments you can put in the text, but that's secondary to information content as I see it. And you get pod2man, pod2html, maybe even a pod2texi, for free. Comments anyone? -mb- P.S> Of course, I myself have little time to do work on any of this ;-).