Front page | perl.perl6.documentation |
Postings from July 2003
Re: Perldoc Project
Thread Previous
|
Thread Next
From:
David Storrs
Date:
July 24, 2003 08:01
Subject:
Re: Perldoc Project
Message ID:
20030724080032.A98505@megazone.bigpanda.com
On Wed, Jul 23, 2003 at 10:49:40PM -0600, Nick Pinckernell wrote:
> Hello All,
> My name is Nick Pinckernell.
Hi Nick,
Other people have already commented on most of your points, so I won't
repeat, except to say that I agree that the name "perldoc" is already
taken, and that POD really is pretty awesome.
> I think this idea would be really good for Perl 6, because, in my opinion,
> POD is lacking.
Something that I think would be a lot more helpful would be to get
involved in the rewrite of POD. The 5.8 spec (which I believe is the
latest???) can be found here:
http://perldoc.com/perl5.8.0/pod/perlpodspec.html
Personally, there are only two things that I wish were different about
POD:
1) The way links (L<>)work. AFAICT, the 5.8 spec answers all my
concerns.
2) Some way to indent command paragraphs and/or "condense" my POD, so
that I could (e.g.) do things like this:
=over 4
=item 1) Foo
=over 4
=item * Bar
=item * Bar
=item * Bar
=item * Bar
=back
=item 2) Foo
=item 3) Foo
=back
Other than that, I think (and have always thought) that POD is pretty
close to perfect.
--Dks
Thread Previous
|
Thread Next