From: Rafael Garcia-Suarez <rgarciasuarez@gmail.com>
Date: Tue, 29 Jun 2004 12:12:58 +0000 (+0000)
Subject: More caveats in B::Deparse's documentation
X-Git-Url: http://git.shadowcat.co.uk/gitweb/gitweb.cgi?a=commitdiff_plain;h=b64ba24ccbc4997863a040c844f7277cafb08de3;p=p5sagit%2Fp5-mst-13.2.git

More caveats in B::Deparse's documentation
(suggested by Yves Orton)

p4raw-id: //depot/perl@23010
---

diff --git a/ext/B/B/Deparse.pm b/ext/B/B/Deparse.pm
index 2db6130..219fc8e 100644
--- a/ext/B/B/Deparse.pm
+++ b/ext/B/B/Deparse.pm
@@ -4584,6 +4584,15 @@ produced is already ordinary Perl which shouldn't be filtered again.
 
 =item *
 
+Optimised away statements are rendered as '???'. This includes statements that
+have a compile-time side-effect, such as the obscure
+
+    my $x if 0;
+
+which is not, consequently, deparsed correctly.
+
+=item *
+
 There are probably many more bugs on non-ASCII platforms (EBCDIC).
 
 =back