develooper Front page | perl.perl5.porters | Postings from April 2010

Re: RFC: Perl manual pages -- update to follow the perlstyle.pod guidelines

Thread Previous | Thread Next
From:
Brad Baxter
Date:
April 5, 2010 06:34
Subject:
Re: RFC: Perl manual pages -- update to follow the perlstyle.pod guidelines
Message ID:
s2tf65b37ea1004050633x6f5e79b0w94e4205fb12be514@mail.gmail.com
On Sun, Apr 4, 2010 at 7:22 AM, Jari Aalto <jari.aalto@cante.net> wrote:
> It can be made visually distict by alternative means. You do not need to
> type monotonic "one space" around every word:
>
>    close FH or die "can't close $path: $!";          # bad
>
>    close FH  or  die "can't close $path: $!";        # better
>

I disagree with "bad", and I disagree with "better".  Sorry.

I, for one (perhaps literally), think this

function( a, b, c );
$hash{ $x };
$array[ $i ];

is better than this

function(a, b, c);
$hash{$x};
$array[$i];

so I'm not shy about an extra space around tokens.
But *two* extra spaces?  Unless it's to align things
vertically, then no, please, not in documentation.

-- 
Brad

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