develooper Front page | perl.perl5.porters | Postings from March 2013

Re: [perl #68706] problem with pod inside function arguments

Thread Next
Aaron Trevena
March 20, 2013 20:01
Re: [perl #68706] problem with pod inside function arguments
Message ID:
First stab at a patch, not sure about the phrasing, somebody more
familiar with the parser could probably add the type of error, but
that could just make it overly verbose.

You do have to actually know what you're looking for to find where it
mentions that perl only expects pod as a new statement, so maybe it
could do with more explanation for beginners writing their first pod.

index 9ea7935..60ebb06 100644
--- a/pod/perlpod.pod
+++ b/pod/perlpod.pod
@@ -645,6 +645,9 @@ empty line there before the first Pod command.
 Without that empty line before the "=head1", many translators wouldn't
 have recognized the "=head1" as starting a Pod block.

+You can place a pod statement where perl expects the beginning of a new
+ statement, but not within a statement, which will result in an error.
 =head2 Hints for Writing Pod


Aaron J Trevena, BSc Hons
LAMP System Integration, Development and Consulting

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