summaryrefslogtreecommitdiff
path: root/pod/perldsc.pod
diff options
context:
space:
mode:
authorKarl Williamson <khw@cpan.org>2015-02-17 09:42:56 -0700
committerKarl Williamson <khw@cpan.org>2015-02-17 10:05:37 -0700
commitbd45a9fb703bf624c943f27a8e99fbfbf56b398e (patch)
treeae27271ce65aedaa482f05df68b0b859d98425be /pod/perldsc.pod
parent828350902c4a64aa014ca4a0448c0e2f86d01647 (diff)
downloadperl-bd45a9fb703bf624c943f27a8e99fbfbf56b398e.tar.gz
perldsc: Wrap too-long verbatim lines
Diffstat (limited to 'pod/perldsc.pod')
-rw-r--r--pod/perldsc.pod27
1 files changed, 18 insertions, 9 deletions
diff --git a/pod/perldsc.pod b/pod/perldsc.pod
index e2c4eae290..7564b97ccc 100644
--- a/pod/perldsc.pod
+++ b/pod/perldsc.pod
@@ -132,7 +132,8 @@ might do well to consider being a tad more explicit about it, like this:
Here's the case of taking a reference to the same memory location
again and again:
- # Either without strict or having an outer-scope my @array; declaration.
+ # Either without strict or having an outer-scope my @array;
+ # declaration.
for my $i (1..10) {
@array = somefunc($i);
@@ -170,7 +171,8 @@ hash constructor C<{}> instead. Here's the right way to do the preceding
broken code fragments:
X<[]> X<{}>
- # Either without strict or having an outer-scope my @array; declaration.
+ # Either without strict or having an outer-scope my @array;
+ # declaration.
for my $i (1..10) {
@array = somefunc($i);
@@ -184,7 +186,8 @@ you want.
Note that this will produce something similar, but it's
much harder to read:
- # Either without strict or having an outer-scope my @array; declaration.
+ # Either without strict or having an outer-scope my @array;
+ # declaration.
for my $i (1..10) {
@array = 0 .. $i;
@{$AoA[$i]} = @array;
@@ -240,9 +243,9 @@ do the right thing behind the scenes.
In summary:
- $AoA[$i] = [ @array ]; # usually best
- $AoA[$i] = \@array; # perilous; just how my() was that array?
- @{ $AoA[$i] } = @array; # way too tricky for most programmers
+ $AoA[$i] = [ @array ]; # usually best
+ $AoA[$i] = \@array; # perilous; just how my() was that array?
+ @{ $AoA[$i] } = @array; # way too tricky for most programmers
=head1 CAVEAT ON PRECEDENCE
@@ -654,7 +657,9 @@ X<hash of hashes> X<HoH>
# print the whole thing sorted by number of members
- foreach $family ( sort { keys %{$HoH{$b}} <=> keys %{$HoH{$a}} } keys %HoH ) {
+ foreach $family ( sort { keys %{$HoH{$b}} <=> keys %{$HoH{$a}} }
+ keys %HoH )
+ {
print "$family: { ";
for $role ( sort keys %{ $HoH{$family} } ) {
print "$role=$HoH{$family}{$role} ";
@@ -667,10 +672,14 @@ X<hash of hashes> X<HoH>
for ( qw(lead wife son daughter pal pet) ) { $rank{$_} = ++$i }
# now print the whole thing sorted by number of members
- foreach $family ( sort { keys %{ $HoH{$b} } <=> keys %{ $HoH{$a} } } keys %HoH ) {
+ foreach $family ( sort { keys %{ $HoH{$b} } <=> keys %{ $HoH{$a} } }
+ keys %HoH )
+ {
print "$family: { ";
# and print these according to rank order
- for $role ( sort { $rank{$a} <=> $rank{$b} } keys %{ $HoH{$family} } ) {
+ for $role ( sort { $rank{$a} <=> $rank{$b} }
+ keys %{ $HoH{$family} } )
+ {
print "$role=$HoH{$family}{$role} ";
}
print "}\n";