develooper Front page | perl.perl6.language | Postings from June 2007

Re: = at Start of Line ... solution is simple

Thread Previous | Thread Next
From:
Dave Whipp
Date:
June 16, 2007 14:23
Subject:
Re: = at Start of Line ... solution is simple
Message ID:
20070616212254.19846.qmail@lists.develooper.com
Darren Duncan wrote:
> Given this, there is an obvious (to me) solution for pod blocks in the 
> middle of expressions like:
> 
>   my $foo
>     = $bar;
> 
> As the example shows, and I believe best practices espouse, you *indent* 
> the code line with a leading =.

I'd agree that indentation is good for readability. But I do know (and 
regularly use) tools that will "helpfully" strip out leading whitespace. 
For example, the bug tracking system I use at work drops all leading 
whitespace; and if you put code in MS-Word using style-sheet indentation 
then cut&paste will drop it. This would be unfortunate.

My problems with these tools would be reduced if the POD identification 
rule was changed from /^=/ to /^=\w/. I.e. whitespace after the initial 
"=" marks it as non-pod.


Dave.

Thread Previous | 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