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

Reply via email to