Add a BUGS section

diff --git a/lib/evil.pm b/lib/evil.pm
index 08a8fe8d8f5012c2e7a8118585439a366fb1f2c0..291a23af898d3112d7dc5464698c8e64cc0f09eb 100644 (file)
--- a/lib/evil.pm
+++ b/lib/evil.pm
@@ -153,6 +153,33 @@ Synonym for C<no evil ':intermediate'>.
 
 =back
 
+=head1 BUGS
+
+The following does not die:
+
+  # Evil.pm
+  package Evil;
+  use evil;
+
+  # A.pm
+  package A;
+  use Evil;
+
+  # B.pm
+  package B;
+  no evil ':intermediate';
+  use Evil;
+
+  # script.pl
+  #!/usr/bin/perl
+  use A;
+  use B;
+
+Since Evil was loaded by A, B does not load Evil and therefore does
+not detect that Evil is... evil. If we loaded B before A in script.pl,
+we would get an exception. So order of loading modules matters for
+intermediate and lax modes. Strict mode is unaffected by this bug.
+
 =head1 CAVEATS
 
 When using intermediate and lax modes, any evil modules loaded before