develooper Front page | perl.module.build | Postings from April 2007

=head2 pod convention for help items

Thread Next
From:
Eric Wilhelm
Date:
April 12, 2007 11:44
Subject:
=head2 pod convention for help items
Message ID:
200704121144.27589.ewilhelm@cpan.org
# from Eric Wilhelm
# on Sunday 18 February 2007 12:25 pm:

>I appear to be the world's only user of interlaced pod.
>
>If I can't get any feedback on whether =head2 would be useful, can I
> at least hear any objections or counter-examples to adding =cut into
> the mix?  This at least allows interlaced pod with the '=item' form.

Ok, so =item doesn't pass podchecker because it sees =cut before the 
=back, and thus kwalitee complains.  Bah.  perldoc didn't mind it.  
That's okay, I never liked using =item for actions anyway.

=head2 it is.  I'll make that change today.

Since I've heard nothing about this for 3 months, I have to assume that 
either nobody documents their build subclass or that everyone who does 
is perfectly happy distancing their pod from their code.

--Eric
-- 
"Because understanding simplicity is complicated."
--Eric Raymond
---------------------------------------------------
    http://scratchcomputing.com
---------------------------------------------------

Thread Next


nntp.perl.org: Perl Programming lists via nntp and http.
Comments to Ask Bjørn Hansen at ask@perl.org | Group listing | About