Front page | perl.perl5.porters |
Postings from March 2001
Pod feature request.
From:
David Muir Sharnoff
Date:
March 28, 2001 00:56
Subject:
Pod feature request.
Message ID:
200103280856.AAA86978@idiom.com
For most of today, I've been writing documentation on an in-house
perl module. For some reason, I thought there was a pod directive
"=both" that would indicate that the following text should be
processed by the perl compiler and included in the documentation.
An expectation of literate programming or something.
Anyway, I wrote my documentation that way only to discover when it
was time to test to make sure I didn't break anything that =both doesn't
exist.
Well, it should.
Since this module is internal-only for the time being, I
added a pre-processor to solve my problem. However, the rest
of the world can probably benefit from same directive.
It appears there are a lot of POD-related modules. If the specification
for POD gets changed, the following people have POD-realted modules in
CPAN that aren't based on Pod::Parser:
ianc@mincom.co
kjahds@kjahds.com
neilb@cre.canon.co.uk
richardj@1gig.net
tchrist@mox.perl.com
pvhp@best.com
matt@sergeant.org
Raphael_Manfredi@pobox.com
afj@afco.demon.co.uk
joseph@5sigma.com
Please consider this feature request.
Thanks,
-Dave
-
Pod feature request.
by David Muir Sharnoff