Add the warning elsewhere too why not
Shawn M Moore [Tue, 28 Apr 2009 09:11:32 +0000 (05:11 -0400)]
lib/Perl/Critic/Dynamic/Moose.pod
lib/Perl/Critic/Policy/DynamicMoose.pm

index baffdf5..af70989 100644 (file)
@@ -4,6 +4,21 @@
 
 Perl::Critic::Dynamic::Moose
 
+=head1 DESCRIPTION
+
+=head1 WARNING
+
+B<VERY IMPORTANT:> Most L<Perl::Critic> Policies (including all the ones that
+ship with Perl::Critic> use pure static analysis -- they never compile nor
+execute any of the code that they analyze.  However, this policy is very
+different.  It actually attempts to compile your code and then compares the
+subroutines mentioned in your code to those found in the symbol table.
+Therefore you should B<not> use this Policy on any code that you do not trust,
+or may have undesirable side-effects at compile-time (such as connecting to the
+network or mutating files).
+
+For this Policy to work, all the modules included in your code must be
+installed locally, and must compile without error.
 =head1 AUTHOR
 
 Shawn M Moore, C<sartak@bestpractical.com>
index 147bef4..f70e783 100644 (file)
@@ -111,6 +111,20 @@ Prohibit public builder methods for attributes. [Severity: 3]
 
 =back
 
+=head1 WARNING
+
+B<VERY IMPORTANT:> Most L<Perl::Critic> Policies (including all the ones that
+ship with Perl::Critic> use pure static analysis -- they never compile nor
+execute any of the code that they analyze.  However, this policy is very
+different.  It actually attempts to compile your code and then compares the
+subroutines mentioned in your code to those found in the symbol table.
+Therefore you should B<not> use this Policy on any code that you do not trust,
+or may have undesirable side-effects at compile-time (such as connecting to the
+network or mutating files).
+
+For this Policy to work, all the modules included in your code must be
+installed locally, and must compile without error.
+
 =head1 AUTHOR
 
 Shawn M Moore, C<sartak@bestpractical.com>