Re: documentation correction (i.e. patch) for perlsyn.pod

Robin Barker <rmb@cise.npl.co.uk> wrote
> Is this the right correction for perlsyn.pod regarding  C<if BLOCK BLOCK> ?
>
> Is it too honest??

It doesn't seem sensible to fill up the pods with history like this.
In fact, perltrap has listed the feature as discontinued rather than
deprecated, since at least 5.002.  It's been gone for well over a year
and nobody's complained.   Let's just bury it.    I suggest replacing
Robin's patch by

p5p-msgid: <E0vilLh-0000M6-00@ursa.cus.cam.ac.uk>

diff --git a/pod/perlsyn.pod b/pod/perlsyn.pod
index 9cf39a3..91a601a 100644 (file)
--- a/pod/perlsyn.pod
+++ b/pod/perlsyn.pod
@@ -220,11 +220,8 @@ If the word C<while> is replaced by the word C<until>, the sense of the
 test is reversed, but the conditional is still tested before the first
 iteration.
 
-In either the C<if> or the C<while> statement, you may replace "(EXPR)"
-with a BLOCK, and the conditional is true if the value of the last
-statement in that block is true.  While this "feature" continues to work in 
-version 5, it has been deprecated, so please change any occurrences of "if BLOCK" to
-"if (do BLOCK)".
+The form C<while/if BLOCK BLOCK>, available in Perl 4, is no longer
+available.   Replace any occurrence of C<if BLOCK> by C<if (do BLOCK)>.
 
 =head2 For Loops