develooper Front page | | Postings from April 2007

=head2 pod convention for help items

Thread Next
Eric Wilhelm
April 12, 2007 11:44
=head2 pod convention for help items
Message ID:
# 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.

"Because understanding simplicity is complicated."
--Eric Raymond

Thread Next Perl Programming lists via nntp and http.
Comments to Ask Bjørn Hansen at | Group listing | About