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

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

Thread Next
From:
Aaron Trevena
Date:
March 20, 2013 20:01
Subject:
Re: [perl #68706] problem with pod inside function arguments
Message ID:
CAJWQ4V1Fq3bCw+Aw5Z33dzCw4SM==AJf1fwo9ZTU6mK9aYUc4Q@mail.gmail.com
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

 =over


-- 
Aaron J Trevena, BSc Hons
http://www.aarontrevena.co.uk
LAMP System Integration, Development and Consulting

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