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 (file)
--- 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