develooper 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



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