From: Chris Dean <ctdean@aig.jpl.nasa.gov>
To: ZSH mailing list <zsh-workers@math.gatech.edu>
Cc: Mark Borges <mdb@cdc.noaa.gov>
Subject: Re: ZSH presence on WWW cf. Perl
Date: Fri, 15 Mar 1996 16:27:30 -0800 [thread overview]
Message-ID: <199603160027.QAA24120@clusterer.jpl.nasa.gov> (raw)
In-Reply-To: Your message of "Fri, 15 Mar 1996 16:56:54 MST." <9603152356.AA07279@suomi.cdc.noaa.gov>
Mark Borges <mdb@cdc.noaa.gov> writes:
> Has anyone seen the Perl WWW page lately? It's at
>
> http://www.perl.com/perl/
Yes, it's very good.
> In particular, I'd like to suggest that the baseline documentation be
> converted to something other than nroff, such as perlpod.
This seems like a great idea. I've been writing a lot (for me at
least) documentation recently using perlpod and am quite taken with
it. It is so easy to make simple pages that I find myself actually
giving my end users documentation much quicker than I used to.
In the past I used TeX, but that made it difficult to distribute
online documentation.
The caveat is that perlpod's "intent is simplicity, not power", and
that you can't do complex things.
We should also provide a zsh*.man as well as a zsh*.pod for those
people who don't have Perl installed.
> And you get pod2man, pod2html, maybe even a pod2texi, for free.
As of today the pod2texi isn't very usable.
Chris Dean
next prev parent reply other threads:[~1996-03-16 0:43 UTC|newest]
Thread overview: 10+ messages / expand[flat|nested] mbox.gz Atom feed top
1996-03-15 23:56 Mark Borges
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 [this message]
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=199603160027.QAA24120@clusterer.jpl.nasa.gov \
--to=ctdean@aig.jpl.nasa.gov \
--cc=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).