zsh-workers
 help / color / mirror / code / Atom feed
From: Mark Borges <mdb@cdc.noaa.gov>
To: ZSH mailing list <zsh-workers@math.gatech.edu>
Subject: ZSH presence on WWW cf. Perl
Date: Fri, 15 Mar 1996 16:56:54 -0700	[thread overview]
Message-ID: <9603152356.AA07279@suomi.cdc.noaa.gov> (raw)

[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 ;-).



             reply	other threads:[~1996-03-16  0:07 UTC|newest]

Thread overview: 10+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
1996-03-15 23:56 Mark Borges [this message]
1996-03-16  0:12 ` Richard J. Coleman
1996-03-18  8:30   ` Bas V. de Bakker
1996-03-18  8:47     ` Peter Stephenson
1996-03-18 15:44     ` Vidiot
1996-03-16  0:27 ` Chris Dean
1996-03-16  6:12 ` Zefram
1996-03-18  8:21   ` Bas V. de Bakker
1996-03-18  9:07     ` Zefram
1996-03-18 19:47       ` Mark Borges

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

  Avoid top-posting and favor interleaved quoting:
  https://en.wikipedia.org/wiki/Posting_style#Interleaved_style

* Reply using the --to, --cc, and --in-reply-to
  switches of git-send-email(1):

  git send-email \
    --in-reply-to=9603152356.AA07279@suomi.cdc.noaa.gov \
    --to=mdb@cdc.noaa.gov \
    --cc=zsh-workers@math.gatech.edu \
    /path/to/YOUR_REPLY

  https://kernel.org/pub/software/scm/git/docs/git-send-email.html

* If your mail client supports setting the In-Reply-To header
  via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line before the message body.
Code repositories for project(s) associated with this public inbox

	https://git.vuxu.org/mirror/zsh/

This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for NNTP newsgroup(s).